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INTRODUCTION 

1. NEWSCOOP FOR EDITORS AND JOURNALISTS 

2. FEATURE LIST 



1 . NEWSCOOP FOR EDITORS AND 
JOURNALISTS 

Newscoop is a multi-lingual enterprise content management system for on-line newspapers 
and magazines, enabling scheduled publishing of multimedia. Built-in revenue generation 
features include support for both trial and paid reader subscriptions. The interface is built with 
the journalist, editor and publisher in mind, based on feedback from the news organizations 
around the world that have deployed Sourcefabric's newsroom software since the launch of 
the first version of Campsite in 1999. Newscoop follows a print publishing model, so it 
structures websites as Publications, Issues, Sections and Articles by default. Newscoop was 
designed for medium-to-large on-line publications, but it is capable of handling nimbler sites 
too. 
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With Newscoop, you can edit articles using an advanced WYSIWYG interface, and manage 
articles translated into different languages. A traditional editorial process ensures quality of 
content: the journalist writes the article, the editor reviews the content, and then the article 
can be published. The Newscoop editorial interface works in most modern web browsers, 
including Mozilla Firefox and Microsoft Internet Explorer. No browser plug-ins are necessary. 
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You can also create your own definition of what a particular type of article should include. For 
example, one article type might consist of "Intro", "Body", and "References", while another 
type might include only "Body" and "Author Bio". You can incorporate images, audio and video 
into your articles, for delivery directly in the browser window or as attachments for download. 
Articles can be categorized with topics, and scheduled for release at a future date, or 
published immediately. 

Newscoop offers full control over the look and feel of your web site via a flexible HTML5 and 
CSS3 ready templating engine. The PHP object-oriented API enables your website developers 
to build third-party plug-ins too. Built-in support for translation allows the user interface to be 
adapted to support new languages quickly and easily. 

Managers will appreciate the fine-grained access control for different types of staff users, 
including journalists, editors, and subscription managers. Integrated revenue-generating 
features include IP-based access control for paid group subscriptions. 

Newscoop is Open Source software released by Sourcefabric under the GNU General Public 
License. It incorporates TinyMCE from Moxiecode Systems AB as its WYSIWYG text editor, 
Christophe Dolivet's EditArea as a template editor, and PhotoViewer by Joseph Nicora for 
thumbnail zooming. 
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FEATURE LIST 



This list of features is provided as a guide to help you decide if Newscoop is the right content 
management system for your publication. 

LANGUAGES 

The Newscoop administration interface has been translated into the following languages (in 
alphabetical order): 



1 


Arabic 


2 


Belarusian 


3 


Chinese (Simplified) 


4 


Chinese (Traditional) 


5 


Croatian 


6 


Czech 


7 


Dutch 


8 


English 


9 


French 


10 


Georgian 


11 


German 


12 


Korean 


13 


Polish 


14 


Portuguese 


15 


Romanian 


16 


Russian 


17 


Serbian (Cyrillic) 


18 


Serbo-Croatian (Latin) 


19 


Spanish 


20 


Swedish 



Further translations can be added using a tool built into Newscoop called the "Localizer". 

CONTENT FEATURES 

1. Multi-lingual content: all of the content that you create in Newscoop can be translated: 

• Articles 

• Sections 

• Issues 

• Publications 

• Topics (content categorization) 

• File attachment descriptions 

• Online WYSIWYG editor for article editing: 

• Typical style formatting: bold, italic, etc. 

• Special support for linking to existing (internal) articles 

• Ability to split articles into multiple pages 

• Insert images into your articles 

• Copy & Paste clean text from Microsoft Word or OpenOffice.org (while preserving bold 
and italics) 

• Insert subtitles, which can be used for breaking up the article (pagination) 



• Built with multiple simultaneous users in mind 

• While a journalist is editing an article, it is "locked". A warning will be displayed if anyone 
else tries to edit the article at the same time. This prevents one journalist from deleting 
the work of another 

• Group articles into sections 

• Group sections into an issue 

• Release an issue all at once 

• Allow subscribers to access only certain issues 

• Scheduled Publishing: automatically publish articles or issues at some time in the future. 
For articles, you can schedule the following actions: 

• publish 

• unpublish 

• show the article on the front page 

• remove the article from front page 

• show the article on the section page 

• remove the article from the section page 

• Topics: Categorize your content 

• Define however many topics you like 

• Associate any number of topics to an article 

• Topic can have subtopics, subtopics can have sub-subtopics, etc. 

• Topics can be translated 

• Dynamic, Flexible Article Types 

• "Article Types" allow you to define your own article format - you aren't limited to just 
"Introduction" and "Body" fields, for instance. An Article Type consists of a series of data 
fields 

• You can define any number and combination of the following field types: 

o date field 

o single-line text field 

o multiple-line text field with WYSIWYG editor 

o drop-down selection containing a list of topics 

• Reorder how the fields are displayed in the admin interface 

• Hide fields that are no longer in use 

• Translate the field names 

• Change the data type for a field 

• Image Manager 

• View/search all of the images in the system 

• Edit image metadata 

• Scale images any way you want on the fly. Scaled versions are cached 

• File Attachments 

• Attach files to articles 

• Files can have descriptions 

• You can specify whether the file should be displayed in the browser or popup a download 
window 

• Comments 

• Readers can make comments to articles 

• Comments can be linked to a forum 



• Flexible implementation: allow anyone to comment, just subscribers, logged in 

• Comments can be moderated 

• Built-in CAPTCHA for spam prevention 

• Works with SSL on both the front-end and back-end 

SUBSCRIBER MANAGEMENT 

1. Control access to your content via: 

• User's IP Address (for corporate accounts) 

• Login/password (individual users) 

• Control what content your subscribers have access to: 

• The entire issue 

• Specific sections in each issue 

• Specific sections in a particular language 

• Ability to have a trial subscription period 

• Set your own pay periods (the time between each payment made by a subscriber) 

SITE DESIGN 

Newscoop has its own template language specifically made for online newspapers and 
magazines. It allows you to customize your site however you want. 

• You have access to the following data objects: 

o publications 

o issues 

o sections 

o articles 

o topics 

o current user 

o current language (e.g. automatically show the user an article in their language) 

• Control statements such as IF and LIST 

• Include other templates 

• Built on the SMARTY templating engine which allows easy customization and inclusion of 
third party modules 

ADMINISTRATION 

1. Fine-grained access control, you can create different user types such as: 

• journalists 

• editors 

• photographers 

• photo editors 

• subscriber managers 

• site administrators 

• Logging 

• All administration actions are logged 

• Security 



• Login page secured against automated scripting attacks with a CAPTCHA 

• Login password is encrypted when sent to the server 

• Backup 

• Command-line "backup" and "restore" scripts make it easy to backup your entire site 
and restore it with one command 

• You can also easily transfer your site from one server to another using these scripts 

• Automated Feedback and Bug Reporting 

• If something goes wrong in the administration interface, a special screen will appear 
which allows you to submit the problem back to the Newscoop team 

• You can also submit feedback directly in the administration interface, such as 
suggestions or feature requests 

DEVELOPERS 

• Completely open-source LAMP development stack (Linux, Apache, MySQL, and PHP) 

• Easy to use object-oriented API to develop plugins or alternative interfaces 

• Easy-to-read code 

• Open development process - all planning, specs, and reviews are done in the open. 
Developing Newscoop is a community process 

SUPPORT 

• Paid per-incident support is available from Sourcefabric (http://www.sourcefabric.org) . 
Guaranteed support contracts ensure a 24-hour response time 

• If you need additional features in Newscoop, they can be ordered from Sourcefabric at a 
very reasonable cost and delivered in a timely manner 

• Sourcefabric has a team of full-time developers working to make Newscoop easier to 
use, with the features you want 

• Community support is available via mailing lists and forums 
(http://forum.sourcefabric.org) 



INSTALLATION 

3. AUTOMATED INSTALLATION 

4. MANUAL INSTALLATION 

5. INSTALLATION STEPS 



3 



AUTOMATED INSTALLATION 



Ready made packages of Newscoop are available for Debian and Ubuntu GNU/Linux via secure 
apt . This is the recommended installation method for Newscoop, because it offers automatic 
updates and resolution of package dependencies. This guide assumes that you have sudo or 
root powers on the target server - if not, you need to ask your system administrator to 
install Newscoop for you. 

INSTALLING MYSQL 

Two components of MySQL are needed for Newscoop: 

• the server 

• the client programs 

Depending on your requirements, you may prefer to run the MySQL database server on a 
separate machine from the MySQL client. The client must be installed on the same machine as 
Newscoop. On Debian/Ubuntu, installing the mysql-server metapackage will install the latest 
versions of both the server and client packages. 

$ sudo apt-get install mysql-server 

During the installation of MySQL, you should be prompted to set a root password for the 
MySQL server, which is an important security feature. Make a note of this password and keep 
it in a secure place, as you will need it shortly. 

Z\ 

Note that the MySQL root user is different from the system root user, and should have a 
different password. 

SETTING UP THE DATABASE USER AND PASSWORD 

An existing Newscoop installation should have a named database already set up on a MySQL 
server, with access protected by a username and password. For a new installation of 
Newscoop, you will need to tell the installer to create a database to store your content in. 
This means you will need a MySQL user account with database creation privileges set up in 
advance. If you don't already have an account, you can set up a database username and 
password for the Newscoop installer to use with the following steps. 

1. Connect to the database management system using the root account and the password 
that you set during the MySQL installation. 

$ mysql -u root -p 

Enter password: 

Welcome to the MySQL monitor. Commands end with ; or \g. 

Your MySQL connection id is 34 

Server version: 5. 1 . 41-3ubuntul2 . 8 (Ubuntu) 

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. 

2. The shell prompt will change to a mysql> prompt, which requires a semicolon at the end of 
each command. Create a user account for Newscoop to connect to the database, limiting it to 
connecting from the localhost if Newscoop and MySQL are to be installed on the same server. 
Otherwise, specify the server that Newscoop will be connecting to MySQL from. Make a note 
of the username (newscoop_user in the example below) and password 
(hewscoop_user_password in the example) that you set, in a secure place. You will need 



these details during the Newscoop installation. 

mysql> CREATE USER ' newscoop_user '@ ' localhost ' 
-> IDENTIFIED BY ' newscoop_user_password ' ; 
Query OK, rows affected (0.04 sec) 

4. Grant access privileges to the user you just created. In this example, newscoop.* means all 
tables of a database called newscoop, which has not yet been created. You will need to 
provide this database name to the Newscoop installer, so that it can create the database 
later. 

mysql> GRANT ALL ON newscoop.* 

-> TO 'newscoop_user '@'localhost ' ; 
Query OK, rows affected (0.00 sec) 

5. Exit from the database management system and return to the shell prompt. 

mysql> quit; 
Bye 

$ 

INSTALLING DEPENDENCIES 

The apache2 metapackage will install all of the web server packages you need. 

$ sudo apt-get install apache2 

The php5-cli, php5-mysql and php5-gd modules must be installed. 

$ sudo apt-get install php5-cli php5-mysql php5-gd 

The imagemagick package is needed for creating thumbnails. 

$ sudo apt-get install imagemagick 

The wwwconfig-common package helps set up the web server for you. 

$ sudo apt-get install wwwconfig-common 

PHP CONFIGURATION 

The php.ini file contains some default settings which should be checked or adjusted to enable 
optimum Newscoop performance and security. You can do this by opening the file in your text 
editor: 

$ sudo nano /etc/php5/apache2/php. ini 

You may wish to adjust the following two settings, which affect the maximum size of media 
that Newscoop users can upload. 

1. The maximum size of POST data that PHP will accept defaults to 8MB on Debian/Ubuntu. 
You may find that you need to set this higher, for example: 

post_max_size = 100M 

2. The maximum allowed size for uploaded files defaults to 2MB on Debian/Ubuntu. This is 
likely to be insufficient for large multimedia attachments, so you may wish to set this value 
higher. However, it must not be higher than the maximum POST size set above, otherwise 
large uploads may fail. 

upload_max_f ilesize = 100M 

3. You may also wish to disable automatic session garbage collection, which can cause 
permissions errors to be shown in the browser. Debian and Ubuntu use a cron job 
/etc/cron.d/php5 to perform garbage collection instead. 
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session. gc_probability = 

Press Ctrl+O to write out the php.ini file, and Ctrl-X to quit the nano editor. 

INSTALLING THE ALTERNATIVE PHP CACHE 

This step is optional, but highly recommended for optimum Newscoop performance. On Debian 
or Ubuntu, you can install APC with the following steps: 

$ sudo apt-get install php-apc 

Then restart Apache to enable the APC module. 

$ sudo /etc/init .d/apache2 restart 

SETTING UP THE SECURE APT REPOSITORY 

To add the repository that contains the Newscoop software, open the sources. list file in the 
nano editor with: 

$ sudo nano /etc/apt/sources. list 




Type your password, and the sources. list file will open. For Ubuntu Lucid LTS, scroll to the end 
of this document and add the following line: 

deb http://apt.64studio.com/backports/ lucid-backports main 

For Ubuntu Maverick, substitute maverick-backports in place of lucid-backports. For Debian 
Squeeze, substitute squeeze-backports in place of lucid-backports. 



tt newer versions of sone applications which nay provide useful features* 
tt Also, please note that software in backports HILL NOT receive any review 
tt or updates fron the Ubuntu security tean. 

* deb http://gb.ai^ive.ubuntu.coii/ubuntu/ lucid-backports nain restricted universe nultiverse 

* deb-src http://gb.ai^ive.ubuntu.coii/ubuntu/ lucid-backports nain restricted universe nultiverse 

tt Unconnent the following two lines to add software fron Canonical "s 

tt 'partner' repository* 

tt This software is not part of Ubuntu, but is offered by Canonical and the 



t deb http://archive*canonical*con/ubuntu lucid partner 
t deb-src http://archive.caiionical.coii/ubuntu lucid partner 

deb http://security.ubuntu.con/ubuntu lucid-^security nain 
deb http://security.ubuntu.con/ubuntu lucid-^security universe 

t local repo 

t deb httpI/Zlocalhost/backports E4studio nain 

t deb^src http?//localhost/backports frtstudio nain 

t deb httpi/Zlocalhost/backports lucid-backports nain 

t deb-src http://localhost/backports lucid-backports nain 

deb http://apt.G4studio.con/backports/ lucid-backports nain 



Press Ctrl+O to write out the sources. list file, and Ctrl-X to quit the nano editor. 
You now need to update your sources. Type: 



$ sudo apt-get update 

You will probably see an error message about a missing public key. 




To fix this, you need to install the 64studio-apt package, which contains the package signing 
key: 

$ sudo apt-get install 64studio-apt 




Update your sources again, to confirm that you are now using a trusted software repository: 
$ sudo apt-get update 

You should no longer see the error message about the public key. After this, you can install 
the Newscoop package: 

$ sudo apt-get install newscoop 

This command will install all of the Newscoop components, plus any other packages that 
Newscoop requires in order to run. 
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Finally, check that Newscoop is running. Open a web browser with the URL of the Apache 
ServerName or ServerAlias that you set up earlier. If you see the Newscoop installer page, 
you can now skip the chapter Manual Installation and proceed to the chapter Installation Steps. 
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4. 



MANUAL INSTALLATION 



The following manual installation method is intended for more experienced system 
administrators, and assumes that you have sudo or root powers on the target server. If 
ready-made packages of Newscoop are not available for your GNU/Linux distribution of choice, 
you can install the software manually using the tarball available for download from 
Source Forge: 

http://sourceforge.net/projects/newscoop/files/ 
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DEPENDENCIES 

Before performing a manual installation, you will have to verify that all of the dependency 
packages that Newscoop requires are already installed and working. These dependencies are: 

1. Apache web server (http://www.apache.org) version 2.0.x or newer. 

On Debian or Ubuntu GNU/Linux, you can install the apache2 metapackage, which will install 
all of the web server packages you need. 

$ sudo apt-get install apache2 

2. MySQL database management system (http://www.mysql.com) version 5.0 or newer. 
Two components of MySQL are needed for Newscoop: 

• the server 

• the client programs 

These components are usually packaged separately, because you may prefer to run the 
MySQL server on another machine from the MySQL client, which must be installed on the 
same machine as Newscoop. On Debian/Ubuntu, installing the mysql-server metapackage wil 
install the latest versions of both the server and client packages. 

$ sudo apt-get install mysql-server 

During the installation of MySQL, you should be prompted to set a root password for the 
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MySQL server, which is an important security feature. Make a note of this password and keep 
it in a secure place, as you will need it shortly. 



-| Configuring mysql-server-5. 1 |- 



While not mandatory, it is highly recommended that you set a password 
for the MySQL administrative "root" user. 

If this field is left blank, the password will not be changed. 

New password for the MySQL "root" user: 




Note that the MySQL root user is different from the system root user, and should have a 
different password. 

3. PHP scripting language (http://www.php.net) version 5.0 or newer. 
The following PHP modules must be installed: 

• php5-cli - Command Line Interface module 

• php5-mysql - functions for accessing the MySQL database server 

• php5-gd - provides a module for handling graphics from PHP scripts 

$ sudo apt-get install php5-cli php5-mysql php5-gd 

These modules have the same names in the equivalent Debian/Ubuntu packages. You will also 
need the PHP module for the Apache web server, which has the package name Iibapache2- 
mod-php5 in Debian/Ubuntu. This package should be installed automatically as a dependency 
when installing the PHP packages mentioned above. 

4. ImageMagick (http://www.imagemagick.org) . 

Needed for creating thumbnails of images. Available in Debian/Ubuntu's imagemagick 
package. 

$ sudo apt-get install imagemagick 

All of these Newscoop dependencies are available as standard packages in most GNU/Linux 
distributions. You should be able to find them using your distribution's software package 
manager, although the exact package names can vary from the examples given above for 
Debian/Ubuntu. 

SETTING UP THE DATABASE USER AND PASSWORD 

An existing Newscoop installation should have a named database already set up on a MySQL 
server, with access protected by a username and password. For a new installation of 
Newscoop, you will need to tell the installer to create a database to store your content in. 
This means you will need a MySQL user account with database creation privileges set up in 
advance. If you don't already have an account, you can set up a database username and 
password for the Newscoop installer to use with the following steps. 

1. Connect to the database management system using the root account and the password 
that you set during the MySQL installation. 



$ mysql -u root -p 
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Enter password: 

Welcome to the MySQL monitor. Commands end with ; or \g. 

Your MySQL connection id is 34 

Server version: 5. 1 . 41-3ubuntul2. 8 (Ubuntu) 

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. 

2. The shell prompt will change to a mysql> prompt, which requires a semicolon at the end of 
each command. Create a user account for Newscoop to connect to the database, limiting it to 
connecting from the localhost if Newscoop and MySQL are to be installed on the same server. 
Otherwise, specify the server that Newscoop will be connecting to MySQL from. Make a note 
of the username (newscoop_user in the example below) and password 
(hewscoop_user_password in the example) that you set, in a secure place. You will need 
these details during the Newscoop installation. 

mysql> CREATE USER ' newscoop_user '@ ' localhost ' 
-> IDENTIFIED BY ' newscoop_user_password ' ; 
Query OK, rows affected (0.04 sec) 

4. Grant access privileges to the user you just created. In this example, newscoop.* means all 
tables of a database called newscoop, which has not yet been created. You will need to 
provide this database name to the Newscoop installer, so that it can create the database 
later. 

mysql> GRANT ALL ON newscoop.* 

-> TO 'newscoop_user '@'localhost ' ; 
Query OK, rows affected (0.00 sec) 

5. Exit from the database management system and return to the shell prompt. 

mysql> quit; 
Bye 

$ 

PHP MODULES 

On Debian or Ubuntu, the PHP modules that you have installed should be configured 
automatically, with an entry for each module added to the /etc/php5/apache2/conf.d/ 
directory. You can also create your own PHP customization options using files in that directory, 
which should not be overwritten when the main php.ini file is upgraded. 

On other distributions of GNU/Linux, you may need to add a line for each module to the 
php.ini file, such as /etc/php5/apache2/php.ini or similar. The following extensions should be 
enabled. If the line is already present but starts with the semi-colon comment ';' you will need 
to remove this character for the corresponding extension to work. 

extension=gd. so 
extension=mysqli . so 
extension=mysql.so 

PHP CONFIGURATION 

On any GNU/Linux distribution, the php.ini file contains some default settings which should be 
checked or adjusted to enable optimum Newscoop performance and security. You can do this 
by opening the file in your text editor: 

$ sudo nano /etc/php5/apache2/php. ini 

The recommend settings are that you should: 

1. Turn off register^globals because it's a potential security hole: 

register_globals = Off 

2. Set the amount of memory available to at least 128MB: 
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memory_limit = 128M 

3. Turn off magic quotes: 
magic_quotes_gpc = Off 

4. Allow HTTP file uploads: 
file_uploads = On 

The values above are the default settings on Debian or Ubuntu. You may wish to adjust the 
following two settings, which affect the maximum size of media that Newscoop users can 
upload. 

5. The maximum size of POST data that PHP will accept defaults to 8MB on Debian/Ubuntu. 
You may find that you need to set this higher, for example: 

post_max_size = 100M 

6. The maximum allowed size for uploaded files defaults to 2MB on Debian/Ubuntu. This is 
likely to be insufficient for large multimedia attachments, so you may wish to set this value 
higher. However, it must not be higher than the maximum POST size set above, otherwise 
large uploads may fail. 

upload_max_filesize = 100M 

7. You may also wish to disable automatic session garbage collection, which can cause 
permissions errors to be shown in the browser if your server runs Debian or Ubuntu. These 
GNU/Linux distributions use a cron job /etc/cron.d/php5 to perform garbage collection 
instead. 

session. gc_probability = 

INSTALLING THE ALTERNATIVE PHP CACHE 

This step is optional, but highly recommended for optimum Newscoop performance. On Debian 
or Ubuntu, you can install APC with the following steps: 

$ sudo apt-get install php-pear php5-dev libpcre3-dev 
$ sudo pear config-set php_ini /etc/php5/apache2/php. ini 
$ sudo peel config-set php_ini /etc/php5/apache2/php. ini 
$ sudo peel install ape 

During the peel install ape step, tap the Enter key when prompted to accept the default APC 
settings. Then restart Apache to enable the APC module. 

$ sudo /etc/init .d/apache2 restart 

APACHE CONFIGURATION 

The Apache web server's configuration will need to be adjusted to set the path to the 
Newscoop files and templates. On Debian or Ubuntu, Apache configuration files are usually 
found in the /etc/apache2/sites-available/ directory. 

1. Create a file such as newscoop containing a virtual host definition. 

$ sudo nano /etc/apache2/sites-available/newscoop 

For a publication with the domain name www.example.com, you could use a virtual host 
definition like the following: 

<VirtualHost *:80> 

DocumentRoot /var/www/newscoop 
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ServerName example.com 
ServerAlias www.example.com 
Directorylndex index. php index.html 
<Directory /var/www/newscoop> 

Options -Indexes FollowSymLinks MultiViews 

AllowOverride All 

Order allow, deny 

Allow from all 
</Directory> 
</VirtualHost> 

If the ServerName or ServerAlias that you are using is not yet set up in DNS for this particular 
machine's IP address, you can create a temporary hostname in your /etc/hosts/ file which will 
enable you to test the installation locally. 

2. Disable the default Apache configuration, if you aren't using it. 

$ sudo a2dissite default 

Site default disabled. 

Run '/etc/init . d/apache2 reload' to activate new configuration! 

3. Enable the Newscoop configuration that you just created. 

$ sudo a2ensite newscoop 

Enabling site newscoop. 

Run '/etc/init .d/apache2 reload' to activate new configuration! 

4. You may also need to enable Apache's rewrite module. On Debian/Ubuntu, you can do this 
with the a2enmod command: 

$ sudo a2enmod rewrite 
The server should respond: 

Enabling module rewrite. 

Run '/etc/init . d/apache2 restart' to activate new configuration! 

5. Restart Apache as suggested by the output of the command above, so that the Newscoop 
configuration and the new modules can be loaded: 

$ sudo /etc/init. d/apache2 restart 

The server should respond: 

* Restarting web server apache2 [ OK ] 

6. Extract the Newscoop tarball that you downloaded in your working directory. This action will 
generate a directory named 'newscoop'. 

$ tar -xvzf newscoop-3. 5.0. tar . gz 

7. Change into the 'newscoop' directory, and examine the contents with the Is command. 

$ cd newscoop 
$ Is 

The output of this command should appear similar to: 

ChangeLog COPYING CREDITS documentation INSTALL README src UPGRADE 

8. Copy the contents of the src directory into the DocumentRoot directory of the Apache 
virtual host that you set up, such as /var/www/newscoop/ 

$ sudo cp -r newscoop/* /var/www/newscoop/ 

9. Change the ownership of the DocumentRoot directory to the username of the web server, 
for instance www-data on Debian or Ubuntu. 

$ sudo chown -R www-data /var/www/newscoop/ 
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10. Open a web browser with the URL of the Apache ServerName or ServerAlias that you 
set up earlier. If you see the Newscoop installer page, you are ready to proceed through the 
installation steps. 
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5. 



INSTALLATION STEPS 



At the URL of your publication's new site, Newscoop should display a Pre-installation Check 
page indicating the status of dependencies. 






Progress., 





Requirement 




Status 


PHP >= 5.2 




Yes 


MySQL Support 




Yes 


ExecQ function enabled 




Yes 


SystemQ function enabled 




Yes 


PHP C LI [Command Line) 




Yes 


APC [PHP Cache) Support 




Yes 


GD Image Functions Support 
Session Handling Support 




Yes 

Yes 


Rewrite Module 




Yes 


Document Root Writable 




Yes 


Cron Jobs Writable 




Yes 


Co nfig u ratio n Files Writab le 




Yes 


Templates Folder Writable 




Yes 


Templates Cache Writable 




Yes 


Plugins Folder Writable 




Yes 


B acku p Fo 1 d e r Writab 1 e 




Yes 


Option 

Safe Mode 
Register Globals 


Recommended 

Off 
Off 


Current Set 

Off 
Off 


File Uploads 


On 


On 


Session Auto Start 


Off 


Off 









Pre-installation Check ■* 
License 

Database Settings 
Main Configuration 
Sample Site 
Automated Tasks 
Finish 




If there are any No entries in the Status column, check your Apache server logs for errors. 
Otherwise, click the Next button to run through the installation steps. 

The next step is for you to review the license under which Newscoop is distributed, which is 
the GNU General Public License version 3. Click the Next button if you accept the license 
terms. 
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: LICENSE 
! 1991 

-e Foundation, Inc. 
i. Cambridge, HA G2139, USA 
itribute verbatim copies 
ig it is not allowed. 



lesigned to take away your 
mtrast, the GNU General Public 
freedom to share and change free 
; free for all its users. This 
: of the Free Software 
■ program whose authors commit to 
: oundation software is covered by 

i H nc + o-aH 1 Vmi ran ^nnlh; H + +n 






Progress,, 







P re-installation Check 
License 4 
Database Settings 
Main Configuration 
Sample Site 
Automated Tasks 
Finish 




Next, you need to set the Server Name/Address for the database, which will be locolhost if 
Apache and MySQL are running on the same machine. You only need to enter a number in the 
Server Port field if you are using a non-standard MySQL port. Then enter the User Name, 
User Password and Database Name that you set up earlier. 



m 





Server Nam e^ Address 




localhost 
Server Port: [QptkmaF) 

User Name: 
newscoop user 

User Password: 




Database Name: 

newscoop| 







Progress. 



P re-installation Check 

License 

Database Settings 4* 

Main Configuration 

Sample Site 

Automated Tasks 

Finish 




If you enter a Database Name which already exists on the specified server, you will asked if 
you wish to Overwrite Database. Only click the Yes option if you are very sure that any 
production databases are fully backed up. 
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There is already a database named newscoop. 

If you are sure to overwrite it. check Yes for the option below. If not, just 
change the Database Name and continue. 



Server Nam eJ Address: 

localhost 



Server Port: [Optional) 
3306 



User Name: 

newscoopjjser 



User Password: 



Database Name: 

newscoop 

Overwrite Database: Yesl®l Mo C 



Progress.. 



P re-installation Check 

License 

Database Settings 4 1 

Main Configuration! 

Sample Site 

Automated Tasks 

Finish 




Next is the Main Configuration page, which is where you set the name of your first publication, 
as well as the password and email address for Newscoop's admin user. This user account is 
critical for management of your Newscoop publications, so make sure that you keep the 
password somewhere secure. 
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Site Title: 

The Custodian 



Administrator Password: 



Confirm Password: 



Administrator E-Mail: 



Progress... 



P re-install at ion Check 
License 

Database Settings 
Main Configuration ■* 
Sample Site 
Automated Tasks 
Finish 




Newscoop includes a demonstration publication template which you can use for evaluation 
purposes. For the demo template to work, you will need to set up a Publication alias with 
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your chosen ServerName later. If you already have a template designed, or wish to start with 
an empty template set, click the No, thanks! radio button. 






Please choose a demo tern plate: ' -' No, thanks! 
|®| classic 





/foCustodiait j^M 


1 jwid LinZzirrr.cL ui m Eiacuu 


t ■.'■--•_■.:: '"-v..,- 1 


1 


Sssss— ^- 


r^*- — 







some information 



Progress.. 



P re-install at ion Chec 
License 

Database Settings 
Main Configuration 
Sample Site ^ 
Automated Tasks 
Finish 




The next page of the installer sets up automated maintenance tasks for your Newscoop 
server, using cron jobs. 






Autopublish: Modifies the status of issues and articles scheduled for 
certain actions. 

Eve nts Notif ie r: Se nds e mai Is to ad m i n i strati ve u se rs co ntai n i n g th e 
latest eve nts th at to o k p I ace i n C am psite . 

Inclexer: Indexes the article content (update the search engine 
database]. 

Statistics: Updates Web site statistics. 

Subscriptions Notifier: Sends emails to subscribers alerting them 
when their subscription ends. 



You can read more on this in the Campsite manual. 



Progress... 



Pre-installation Check 
License 

Database Settings 
Main Configuration 
Sample Site 
Automated Tasks 
Finish 




Once installation has completed, two large buttons are shown. Clicking on the upper button, 
with a tools icon, redirects you to the Newscoop administrator interface. The lower button 
takes you to the Sourcefabric website, for further information and support on Newscoop. 
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Progress,, 




M 



We Ice me to 
Sourcefabric 



P re-installation Check 
License 

Database Settings 
Main Configuration 
Sample Site 
Automated Tasks 
Finish * 
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GETTING STARTED 



Newscoop enables you to host multiple, multi-lingual publications on the same web server. The 
process of setting up a new on-line publication with Newscoop can be divided into three steps: 

1. Configuring the publication, and specifying the templates to be used 

2. Establishing the structure of your publication, with issues and sections 

3. Adding content, managing content, and publishing it 

This part of the Newscoop manual is aimed at editors and journalists working their way 
through these three steps. It assumes that the web server you will use is already up and 
running with Newscoop, and that templates have been designed for your publication. If you do 
not yet have your own Newscoop server running, you can follow the steps in this manual using 
the Newscoop demonstration server and sample templates provided by Sourcefabric. 

The first step begins with logging in to the administration interface of your Newscoop server. 
This is a special interface which is only available to the staff of your publication. Readers who 
subscribe to your online publication will log in using the home page of your website instead. 

By default, the URL you should enter into your web browser for the administration interface is 
the name of your website, followed by 'admin'. For example: 

http://www.example.com/admin/ 

If you installed Newscoop yourself, you would have set a password for the 'admin' user during 
the installation steps. If not, your system administrator should already have provided you with 
a login account name and password. Below the Account name and Password fields, click the 
drop-down menu to select an interface language other than the default of English, if you wish. 
Then click the Login button. 



Newscoop 

SOURCEFABRIC 



Login 

Please enter your user name and password 
Account name : 
Password : 



admin 



Language : | English 

Forgot your password? LOGIN . 



tt 



3 



Alternatively, the Newscoop demonstration server can be found at: 

http://newscoop-demo.sourcefabric.org/admin/ 

Please remember that the demonstration server is a public site, so don't enter any private 
information there. A variety of guest login accounts are set up on this system, and the 
passwords for these accounts are shown on the login page. 
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THE DASHBOARD 



After logging into the admin interface for the first time, you'll see an empty home page which 
Newscoop calls the Dashboard. This an area into which you can add widgets for the 
administration functions that you use most often. In this way, you can customize the 
administration interface to suit your needs. Click on the Add more widgets link to open a 
page where you can select from more than a dozen potential widgets. 



CONTENT ACTIONS v CONFIGURE USERS PLUG INS 



Dashboard 

Add mare widgets 



On the Widgets page, click the Add to dashboard link for each widget that you would like to 
start with. You can refine your choice of widgets later, as you get to know the Newscoop 
administration interface and its functions. 
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CONTENT t ACTIONS ▼ CONFIGURE USERS PLUGINS 



Widgets 




Go to home 










Most Popular Articles 


Pending Articles 




Add to dashboard 


Add to dash hoard 






Admin articles wimjets. 




Admin articles widgets. 






AuthDr: 
Sourcefahrico.p.s. 


Audi or 

Sourcefahrico.p.s. 




Version: 
1.3 


Version: 
10 




Homepage: 
wmv.sourcefahric.org 


Homepage: 
www.sourcefahric.org 






License: 
GPLv3 




License: 
GPLv3 
















Recently Published Articles 


Submitted Articles 




Add to dash hoard 


Add to dash hoard 






Admin articles widgets. 




Admin articles widgets. 




Author: 
Sourcefahrico.p.s. 


Author: 
Sourcefahrico.p.s. 




Version: 
1.0 


Version: 
10 






Homepage: 
www.sourcefahric.org 


Homepage: 

www. so u rcefah ric.o rg 






License: 
GPLv3 




License: 
GPLv3 















After all the widgets that you require have been added to the Dashboard, they change from 
black to green text to show that they are active. Click the Go to home link to return to the 
Dashboard. 



CONTENT ACTIONS CONFIGURE 



Widgets 


Go to home 

IS 








Most Popular Articles 




Pending Articles 

Add to dashboard 




Admin articles widgets. 




Admin articles widgets. 




Author: 
Sourcefahrico.p.s. 


Author: 
Sourcefahrico.p.s. 




Version: 
1.0 




Version: 
10 




Homepage: 
www.sourcefabric.org 




Homepage: 

www. so u rcefah ric.o rg 




License: 
GPLv3 




License: 
GPLvS 











Each widget has three small blue icons in the upper right corner. From left to right, these icons 
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maximize the widget to the full width of your browser window, provide general information 
about the widget, or close it. When a widget is maximized, clicking the close icon returns the 
widget to normal size. 



CONFIGURE 



>oard 

2 widgets 



st Papular Articles 



or: ft 



Showing 1 to 53 of 53 entries 



Name 



Type 



Author 



On Front 



On 

Section 

Page 



Authci 
■ Sourcefabrico.p.s. 

Version: 

10 
. Homepage: 

www.sourcefabric.org 

License: 

GPLvS 



Making the Most of a 
Small Apartment 


News Article 


Sarah 
Staffwriter 


No 


Yes 


24 


August Street Cruise to 
Raise Money for Local 
Charities 


News Article 


Douglas 
Are 1 lanes 


No 


Yes 


41 
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8- HOW PERMISSIONS CHANGE THE 
INTERFACE 



The appearance of the Newscoop administration interface changes, depending on the 
permissions that a particular staff member has. Each user sees only the options that he or 
she has the authority to use. A typical staff user (a section editor or journalist) will only see 
some of the options available to a fully authorized administrator (such as the publisher, or 
senior manager). 

When you log into the Newscoop administration interface, across the top of the page you will 
see the main navigation menu, containing the options available to you. Here is how two typical 
users would see the main menu differently. Firstly, here's how the Actions sub-menu looks 
when an administrator is logged in: 



CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Add new article 
Upload new template 
Add new publication 
Add new staff member 
Add new subscriber 
Add new user type 
Add new article type 



Dashboard 

Add more widgets 



Most Popular Articles 



Sricwir>g l to 53 of 53 entri] Add new co u ntry 
Add new language 



Name 



Making the Most of a SmsJ lrT1 P ortXML 
Apartment 



Change your password 



August Street Cruise to R a i ^ i v i u ii ^ M ■..■'? 
for Local Charities 



Author Status 

Sarah Staffwriter Published 

Douglas Are I lanes Published 



And this is how the same Actions sub-menu looks when a journalist is logged in: 





DASHBOARD 


CONTENT t 

i 


ACTIONS CONFIGURE 


USERS t 
i 


PLUGINS 








[Add new article t 1 










Change your password 




Dashboard 

Add more widgets 
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MAIN MENU 



The main Newscoop menu contains a link to the Dashboard page and up to five sub-menus, 
depending on the permissions of the user who is logged in. These sub-menus are Content, 
Actions, Configure, Users, and Plugins. The menus shown below are for an administrator 
user, who has access to all sub-menu options. 

CONTENT 



Here you can find the Publications on the server, reader Comments, the Media Archive, 

and the Search page for all of the articles in the Newscoop database. For each available 
publication, there are quick links to the latest three issues, and a full list of sections within 
each issue. In the screen shot below, a sample publication called 'the Custodian' has been set 
up, with two issues in both English and Spanish. 




Dashboard 

Add mare widgets 



Publications 
Comments 
Media Archive 
Search 



Most Popular Ancies 



ShcwirHj 1 to 53 of 53 entries 



Name 



Type 



sue 2 [English] 



1. issuel [English] 



e 



Page 



lOn 

Iction Reads 

Page 



ACTIONS 

This menu provides quick access to the most commonly used functions, including 'Add new 
article' and 'Change your password'. 
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CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Dashboard 

Add more widgets 



Most Popular Articles 



Showing 1 to 53 of 53 entri 



Name 

Making the Most of a 
Small Apartment 



Add new article 
Upload new template 



Add new staff member 
Add new subscriber 
Add new user type 
Add new article type 
Add new country 
Add new language 
Change your password 
Import XML 
BackupyRe store 



e 



On Front 
Page 

No 



On 

Section 

Page 

Yes 



Reads 
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CONFIGURE 

Here you can configure the System Preferences for your publication, and a number of other 
functions. Templates are the files which determine how Newscoop displays content to 
readers and subscribers. Article Types describe the format of your articles, while Topics 
allow you to categorize your articles. The Languages option specifies the languages that 
journalists have to choose from when creating articles. Countries enables you to specify the 
name of a country in the local language for each territory. The Localizer allows you to 
translate the administration interface. Clicking Logs will show you the recent activity of all 
staff users, including the IP address that they have logged in from. 



CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Dashboard 

Add more widgets 



Most Popular Articles 



Showing 1 to 53 of 53 entries 



Templates 

Article Types 

Topics 

Languages 

Countries 

Localizer 

Logs 



e 



USERS 

Here you can add and edit Staff users, and manage Subscribers. You can also define Staff 
User Types, or Synchronize Newscoop and Phorum users, integrating this web forum 
system with your publication's site. The Manage Authors page enables you to maintain 
contact and biography information for each of your publication's contributors, as well as track 
the articles that they have worked on. 
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CONTENT - 


ACTIONS t 


CONFIGURE 


USERS PLUGINS 






Staff 

Staff User Types ^* 

Synchronize Newscoop and 
Phorum users 

Manage Authors 




Dashboard 

Add more widgets 






e 




Most Popular Articles 













PLUGINS 

This sub-menu provides access to additional functionality for Newscoop, including Blogs, 
Interviews and Polls plugins. 





CONFIGURE USERS ^ 


PLUGINS 






Manage Plugins 


i 










I T 




Interviews t 


Administer 
Moderate 




Polls 


Preferences 











HELP AND LOGOUT 

Up in the top right corner of the administration interface are two additional links, to the right 
of the full name associated with your login account. Help links you to the on-line version of 
this manual, via the Sourcefabric website. Logout ends your session and returns you to the 
administration login page. 



Signed in: DanielJames Help Logout 
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CREATING A PUBLICATION 



Newscoop content is organized in a hierarchical structure, which conforms to the tradition of 
newspapers and magazines: Publications, Issues, Sections and Articles. Each publication is 
made up of issues; each issue is in turn made up of sections, which are comprised of articles. 
A 'breadcrumb trail' of links is present on every screen, which enables quick navigation 
between different levels of the publishing hierarchy. 

For example, after creating a publication named the "The Custodian", by clicking on "The 
Custodian" in Newscoop's list of publications, you enter the list of issues for that newspaper. 
By clicking the name or number of a particular issue, you enter its list of sections. By clicking 
the name of a section you enter the article list. By clicking the article title in that list, you can 
edit the article. 

To create a new publication, click Content on the main navigation menu, and then click 
'Publications' from the sub-menu. On the Publication List page that appears, click on 'Add new 
publication'. 





CONTENT -r 


ACTIONS t CONFIGURE 


USERS PLUGINS 


Content > 




■#■ Add new publication 








Number Name 

(click tc see issues) 


Default Site Alias 


Default Language Comments enabled 


1 the Custodian 


newscoo p -de v.so u reef ab ri c. o rg 


English 











If your login account does not have administrator rights, you will not be able to see the Add 
new publication' option. You may need to ask your system administrator to enhance your 
access rights. Bear in mind, however, that a good administrator would be reluctant to hand 
over those rights to more than a handful of people. If you are not among those select few, 
your Publications List will only contain the publications already hosted on your Newscoop 
server. 

The Add new publication window has three sections; General attributes and Comments on 
the left, and Subscription defaults on the right. There's a Save button beneath these 
sections. 

The fields in the General attributes section are: 

• Name of the publication (e.g. "The Prague Times") 

• Default Site Alias is the name of the web server on which your publication will be 
hosted (e.g. www.example.com). Newscoop enables multiple publications to be hosted on 
the same web server, providing that a unique alias has been set up for each publication 
by your system administrator 

• Default Language sets the default language of the publication for readers 

• URL type selects between the display of full path URLs, or short URLs which are better 
for pasting into newsletters and social media posts 

• Search engine optimization helps your articles to be found on the Internet 

• Invalid URL Template allows you to specify the page that readers will see if they follow 
a broken or outdated link. For example, you may wish to help lost readers by leading 
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them to a search page 
The fields in the Comments section are: 

• Comments enabled? Check this box if you would like your readers to be able to 
comment on articles 

• Article comments default to enabled? If you check this box, then article comments 
for any new article will default to "enabled" 

• Subscriber comments moderated? If you check this box, comments by subscribers 
will be hidden from readers until they have been reviewed by a staff member 

• Public allowed to comment? Check this box if non-subscribers will be allowed to make 
comments on articles 

• Public comments moderated? If you check this box, non-subscriber comments will be 
hidden from readers until they have been reviewed by a staff member 

• Use CAPTCHA to prevent spam? The reader must type in random letters or numbers 
shown before they can post a comment 

• Moderator address If comments are moderated, each time a comment is posted an 
email is sent to this address, such as 'editorfgtexample.com' 

• From address is the sender email address shown on the email sent to the moderator, 
which should be a valid address in case of bounces. An address such as 
, robot@example.corrr is suitable 
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General attributes 

Name: 

Default Site Alias: 

Default language: 

URL Type: 



The Prague Times 



www.example.conn 



Cesky 



d 



Edit languages 



short names ^j 



Article title 
Search engine optimization: Article keywords 
U Article topics 



Invalid URL Template: 



cl assic/tp l/se arch -b ox.tp I 



• 



Comments 

Comments enabled?: 

Article comments default to enabled?: 
Subscriber comments moderated?: 
Public allowed to comment?: 

Public comments moderated?: 
Use CAPTCHA to prevent spam?: 
Moderator Address: 



s 
s 

+ 



editor@example.com 



From Address: 



robot@example.com 






SUBSCRIPTION DEFAULTS 

The rest of the fields are related to subscriptions, which you can adjust later if you wish. First, 
you have to select a time unit for your subscriptions; which could be days, months, weeks or 
years. 

You can set two types of subscriptions: paid and trial. Paid subscriptions have the following 
properties: 

• Currency: the subscription currency. Even if a subscription request is sent and the 
currency setting is changed before payment, the information about the subscriber's 
payment due is correctly recorded 

• Time unit cost per one section: 

o for one language: the price for access to a particular section in a single language 
o for all languages: the price for access to a section in all available languages 

• Default time period: the usual duration of the paid subscription. This value is used 
when a reader subscribes through the website. The period for a particular subscription 
can be modified from the administration interface 
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Subscription defaults 






Time Unit: 


months t| 




Paid subscriptions 








Currency: 


USD 




Time unit cost per one 


section: 




- one language: 


1.00 










- all languages: 


2.00 










Default time period: 


1 


time units 


Trial subscriptions 






Default time period: 


1 


time units 











After clicking the Save button, Newscoop will confirm that the new publication has been 
created. 



CONTENT ACTIONS t CONFIGURE USERS PLUGINS 



Content > Publication: Tne Prague Times > 
^ Publication List Co To Issues ^ 

4" Add new publication Ejj Delete 

Publication created. 



On the right hand side under the Subscription defaults fields, there will now be a link Set 
subscription settings by country which will enable you specify different default time periods 
for individual countries. 
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Subscription defaults 






Time Unit: 


monttis t| 




Paid subscriptions 








Currency: 


USD 




Time unit cost per one section: 




- one language: 


1JDO 










- all languages: 


2.00 










Default time period: 


1 


time units 


Trial subscriptions 






Default time period: 


1 


time units 


Set subscription 


settings bvxc 


suntrv 






L> 





This link opens the Subscription Settings by Country page, which has a link Set 
subscription settings for a country. 



ACTIONS CONFIGURE USERS PLUGINS 



Content > Publication: The Prague Times > 



+ Set subscription settings for a count i 



Country Defau It ti me pe riod [mo nths) : 
(click to -edit) 



Delete 



trial subscription paid subscription 



If you follow this link, it opens a page with a drop-down menu for selecting the country in 
question, plus fields for the default trial and paid subscription lengths. Clicking the Save button 
returns you to the "Subscription Settings by Country" page, which should now show the setting 
you have just made. 
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CREATING AN ISSUE 



Once you have successfully created your publication, click on its name in the Publication List 
(e.g. "The Prague Times"). This will lead you to the Issue List, which will be empty to begin 
with. 




Content > Publication: The Prague Times > 



+ Set subscription settings for a count i 



Country Default time period [months]: 
(click to edit) 



Delete 



trial subscription paid subscription 



Click on the 'Add new issue' link. If you are creating the very first issue, you will see a page 
with fields for basic information which you will need to enter. 



CONTEN 



USERS PLUGINS 



Content > Publication: The Prague Times > Issues > 



Add new issue 


Name: 

Language: 

Number: 

URL Name: 






January 2011 








Cesky 


_] 






1 




2011_1| 








Cancel 





The Name is the name of the issue in the particular Language you specify in the drop-down 
box underneath. The Number is a unique identifier for this issue. If this is the first issue 
you've ever published, then number "1" would be appropriate. The issue number cannot be 
changed once it is specified. 

If you are planning to add older issues of your publication at a later stage to the same 
Newscoop server, you may consider continuing the series. For example, if you just published 
issue 154 of the "The Prague Times" before moving to Newscoop, you should assign number 
155 to the first issue you are creating with Newscoop. 

The URL Name field is only useful if you specified the "URL type: short names" option when 
you created your publication. This name will show up in the reader's browser address bar. For 
example, if you enter "2011_1" here, the address for the issue might look like this: 

http: //www. example.com/2011_l 
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Clicking the Save button takes you to the Change issue details page, where various options 
for the issue are set. On the left hand side, there are settings for the default templates for 
the front page, sections and articles. If you do not have your own templates yet, you can 
select templates from the 'classic' demonstration set that are provided with Newscoop. 
Reader polls can also be set up and edited on this side of the page. 





DASHBOARD 


CONTENT 


ACTIONS 


CONFIGURE 


USERS 



Content > Publication: The Prague Times > Issue: January 2011 [Cesky) > 



^1 Issue List Go To Sections 1^ 

■^ Add new issue G^ Preview Qy Translate Q Delete 



Change issue details 


Number: 
Name: 

URL Name: 

Language: 

Publication date 
(yyyy-mmHdd): 

Default templates 


1 




January 2011 








2011_1 










Cesky v\ 




Click here to publish thi 


s issue 


Front Page Template: 

Section Template: 

Article Template: 




classic/] ndexipl ▼] 




classicfeectjon.tpl tI 




classic/artjcie.tpl |t| 





* Edit 



On the right hand side of the Change issue details page are boxes which enable you to set 
the publishing schedule for the issue. An issue can be set to be published at a specific date and 
time, and unpublished at another date and time. 
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PLUGINS 





Issue Publishing Schedule 








Date/Time Action Publish articles 


Delete 




2011-01-17 16:00:00 Publish Yes 


□ 


2011-02-17 16:00:00 Unpublish Yes 


□ 














Schedule a new action 










Date: 

Time: 
Action: 


2011-02-17 


n 


16 


30 






Unpublish ▼] 












Publish articles: 


Yes wj 






IL 















COPYING A PREVIOUS ISSUE 

If this is not the first issue you've created, you will see a different page after clicking the Add 
new issue link in the Issue List: 




Content > Publication: Tne Prague Times > Issues > 



D Use th e stru ctu re of th e previ o u s i ssu e 

Copy the entire structure in all languages from the previous issue except for content. 
You may modify it later if you wish. 

D Create a new stru ctu re 

Create a complete new structure. 

You must define an issue type for each language and then sections for them. 



"Use the structure of the previous issue" will be the usual option to choose once you are 
ready to publish additional issues, because it automatically creates a new issue with the same 
sections as the preceding one. Clicking this option opens a page which enables you to specify 
the new issue number. 



41 



CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Content > Publication: The Prague Times > Issues > 



Copy previous issue 



Copy structure from issue number 1 



Issue Number: 2| 






The sections of the new issue will be empty, so that you can begin to add articles. Before 
that, the first step is to set the name of the new issue, because this field is not automatically 
updated: it will start out with the same name as the last issue. After changing the Name and 
URL Name fields, click the Save button to update the new issue. 



CONTENT ACTIONS CONFIGURE USERS 



Content > Publication: The Prague Times > Issue, January 2011 (Cesky) > 
^1 Issue List Go To Sections 1^ 
+ Add new issue G^ Preview l3S Translate Q Delete 



Issue created. 



Change issue details 


Number: 
Name: 

URL Name: 

Language: 

Publication date 
tyyyy-mmHdd): 

Default templates 


2 




February 2011 








2G11_2| 










Cesky ^j 




Click here to publish thi 


b issue 


Front Page Template: 

Section Template: 

Article Template: 




classic/index.tpl ▼] 




classic/section.tpl -wl 




classic/artjcle.tpl t| 





* Edit 



The previous templates are not copied to the new issue automatically, so the new issue must 
be linked to at least a template for the front page. 
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12. 



CREATING A SECTION 



By clicking on the name of an issue in the Issue List, you will enter the Section List. At first, a 
new issue will have no sections. 



CONTENT t ACTIONS t CONFIGURE USERS PLUGINS 



Content > Publication: Tne Prague Times > Issue: January 2011 (Cesky) > 



^ Issue List + Add new . section 

No sections 



If you click on the 'Add new section' link, you will see the corresponding page appear. Here you 
must specify the Name, section Number, and URL name for the new section. While you can 
change the name of the section later, the section Number is set at the time when the new 
section is added. The URL name will be part of the URL for the new section, if you set the 
"short names" option when you created the publication. 



CONFIGURE 



Content > Publication: Tne Prague Times > Issue: January 2011 (Cesky] > Sections > 



Add new section 








Name: 


Property 










Description: 


The hottest real estate deals in Prague 








Number: 


1 












URL Name: 


1 




Subscriptions: I 


3 1 Add section to all subscriptions. 

■ 


H 
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The section Description is optional. This field is useful for displaying content that doesn't 
change very often. The information in this field will only be displayed on your site if the 
template you are using supports it. If you would like to make the new section available to all 
existing subscribers, you should check the box for this option. Then click the Save button. 

Your next step is to set the templates for the new section on the Configure Section page. 



Configure section 



Number: 1 
Name: 

URL Name: 

Subscriptions: 



Property 



d 



Description: j^g hottest real estate deals in Prague 



Default templates 



Section Template: classic/section Jpl 
Article Template: 



d 



classic/article.tpl 



^^^9| 



Here, you may wish to select custom templates for this new section and its articles from the 
drop-down menus. If you don't have custom templates for specific sections, you can use 
general section and article templates instead. Then click the Save button to confirm your 
choice. 
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CREATING AN ARTICLE 



The Article List for a particular section can be found by clicking on Content in the main 
Newscoop navigation menu, and following the hierarchy of Publications, Issues and Sections. 
Alternatively, use the 'breadcrumb trail' of links just below the main navigation menu. You can 
create a new article by clicking the "Add new article" link at the top of the Article List. 



ACTIONS CONFIGURE 



USERS PLUGINS 



Content > Publication: The Prague Times > Issue: January 2011 [tesky] > Section: Property > 
^ Section List ■#■ Add new article 

Select action 



The "Add new article" page contains three fields for entering basic information about the 
article you will create. 



Content > Publication: The Prague Times > Issue: January 2011 [tesky] > Section: Property > Articles > 
^1 Article List 



Add new article 



Name: Librarians Love Loft Living| 



Type: News Article 
Language: Cesky 






• Name: The title of the article. You will be able to rename the article at any time in the 
future 

• Type: Select one of the available article types from the drop-down menu. If you have 
not set up any article types yet, only the default of "News Article" will be available. The 
choice you make at this stage cannot be altered 

• Language: Select the language the article will be written in. A drop-down list will contain 
the additional languages you have defined for this publication, if any. The language choice 
you make at this stage is final, although you can create a translation of the article into 
another language later 

When you click the 'Save' button, you will be taken to the Edit Article page. 
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14. 



EDITING AN ARTICLE 



The appearance of the Edit article page depends on the article type you are working on. 
Below, the default "News Article" type is shown. At the top right are the Edit and View 
buttons, the Save All and Save and Close buttons, and the Actions, Status and Language 
drop-down menus. 



Sianed in: Daniel James Heln Loaout 


Newscoop* 
















Edit 




View 




























Actions... r\ 




Status: New 


J 


Language 


Cesky t] 


KT 













Edit, View and Save buttons 

There may be times when you want to view articles rather than edit them. In this case, 
clicking the View button speeds up the page display process. It also enables you to view an 
article when it is locked by another user on the server. Once the article is published, there will 
also be a Go to live article button here. 

Save All saves the fields in the edit area without closing the page, whereas Save and Close 
both saves the page and closes it, unlocking the page for other authorized users to edit 
further. 

Actions menu 

The Actions menu contains short-cuts to commonly used functions: 

• Unlock: When you begin editing an article, you automatically "lock" it to prevent 
conflicting edits from other users on the server. Using the Unlock option means that 
other authorized users can edit the article again 

• Delete: Removes the article permanently from the Newscoop server 

• Duplicate: Copies the article to any publication, issue, or section on the same Newscoop 
server 

• Translate: Creates a new copy of the article for translation into another language 

• Move: Moves the article to another publication, issue or section on the same Newscoop 
server 

Status menu 

The status drop-down menu indicates the copy flow state of the article. There are four states 
that the article can be in: 

• New: The article is still being written. Once the contributors are ready for the article to 
be seen by the editor, they should change the status to "Submitted" 

• Submitted: The article is under review by the editor or editors. Once the editors decide 
that the article is ready for the public to see, the status should be changed to 
"Published", or scheduled for publication at a later date and time 
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• Publish with issue: The article will be published only when the issue it belongs to is 
published 

• Published: The article belongs to a published issue, and is now viewable by the public 

Language menu 

If multiple languages have been configured for the publication, a drop-down menu will enable 
fast switching between translated versions of the article. If not, the language of the article wil 
be displayed here. 

THE EDITING AREA 

To the left of the Actions and Status drop-down menus is the editing area for the article. 



DASHBOARD CONTENT ACTIONS CONFIGURE 



JSERS PLUGINS 



Content > Publication: The Prague Times > Issue: January 2011 [Oesky) > Section: Property > Article: Libi 



Librarians Love Loft Living 



Authors [*) 



Author 


3 


Jane Q. Reporter 




Photographer 


3 


James Q. Photographer 



E 
H 



Date 



CrBated: 2011-01-17 16:17:44 Q Last modified : 2Q11-Q1-17 16:17:44 
Deck 



As long as there are shelves, they're happy 



Lead and SMS 



b i u^c|^M^^|i^*^«|i^xiaaifei , 9 ' y in|si^& 


HimL g — A - 22 - x 2 x J | ft S.;- B | jE »E | Styles |~|| (Format 


- 


Font family 


rf 1 _ a | a* - | 'n 'TIB IB 


Librarians are snapping up apartments in converted warehouses. There's more space for hooks, tl 


le 


/say. 



The "News article" type has the following fields in the editing area: 

• Name: The title of the article 

• Author: This drop-down menu enables you to credit multiple contributors, including 
Author or Writer, Photographer, Editor, and Columnist. Type the contributor name in the 
box to the right. Click the + icon to include additional contributors, or click the x icon to 
remove them 

• Date: Since this field can order the way your articles are displayed to readers, you can 
change this date if you choose 

• Deck: a sub-heading or article teaser 



48 



• Lead and SMS: a short version of the article, suitable for sending via a text message 
gateway to phones which support the Short Message Service. The length of an SMS text 
message depends on the alphabet used, from a maximum of 70 characters in Chinese or 
Cyrillic alphabets, up to a maximum of 160 characters in the Latin alphabet 

• Body: the main section of the article 

COMMENTS 

Beneath the editing area, there's a box in which you can set reader comments on the article 
to be enabled, if you wish. Your templates must be designed to allow this feature. The radio 
buttons can have one of three values: Enabled, Disabled, or Locked. "Locked" means that 
no one can post comments, but any existing comments are still shown. Click the blue 
Comments link to minimize the box, saving space in your browser window. 



▼ Comments 



® Enabled O Disabled O Locked 

Comments 



® New O Approved O Delete C 



From 


DanielJames 


Date 


2011-01-17 17:27:59 


Subject 


1 never have enough room for books 


Comment 


1 too would love to have a loft apartment with lots of shelves... 


Reply to comment 









Post a Comment 

Author 



Daniel James 



Subject 



Comment 



Submit 



Individual comments can be Approved for publication, Deleted or Hidden, using the radio 
buttons immediately above. Beneath the displayed comments is a form which staff members 
of your publication can use to add a comment of their own, perhaps in reply to a reader 
question. 
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THE SIDEBAR 

On the right side of the editing area is a vertical bar containing further options for the new 
article, in a series of boxes. Like the Comments box, all of the boxes in the sidebar can be 
minimized by clicking on the blue link in the box name. 

Publish Schedule 

Schedule the article to be published or unpublished at a certain date and time. Click the Add 
Event button to open a window with a calendar and publishing options, such as showing the 
article on its section page, or the publication's homepage. 




.11 Apartment [English) > 



Edit 




View 



Saved 16:43:42 



Actions., 



• 



Status: Submitted 



- 



Language 



English ^j 



* Publish Schedule 










+ Add Event 














2011-01-18 16:59:00 X 

• Publish 

• Show on section page 











Locations 

Clicking the Edit button in the Locations box opens a pop-up window which enables you to set 
a geolocation (map reference) for the article. 
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Keywords & Topics 

• Keywords: Enter words that describe your article to search engines 

• Topics: Select from a list of topics and subtopics defined by your Newscoop 
administrator by clicking on the Edit button, which opens a pop-up window. Topics allow 
you to set attributes for the article, which may be used to display the article in a certain 
way 
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After clicking the Save and Close button, the Topics you have selected are displayed in the 
box in the sidebar. 
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Keywords & Topics 



Keywords 



loft, apartment, prague 



Topics 



Save 






i Real Estate 



/Real Estate / Apartments 



y Real Estate I Buying Real Estate 



I Real Estate .' Hot Properties 



Switches 



» Switches 


□ Show anicle on front page 
Show article on section page 
Visible to non-subscribers 






Save 









• Show article on front page: Check this box if you want the article to be displayed on 
your publication's homepage 

• Show article on section page: Check this box if you would like the article to be 
displayed on the relevant section page 

• Visible to non-subscribers: Check this box if you want to make the article visible to 
readers who have not yet subscribed 



Info 



Info 



Reads 


27 


Type 


News Article 


Number 


5 


Created by 


Administrator 



• Reads: A number indicating the popularity of this particular article. An article which has 
not yet been published will display N/A here 

• Type: Refers to the "article type", i.e. the format of the article. You cannot change this 
field once it has been assigned 

• Number: The article's unique identification number 

• Created by: the name of the Newscoop user who created this article. You cannot 
change this field 



Media 



The Media box has two tabs, Images and Attachments. 
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t Media 



Images 


Attachments 





+ Attach 



201. 

■ | 430x430 




Images: You can attach images to your article which can be included directly into an 
article body field, or used in the template 

Attachments: You can attach any kind of file you wish to the article. The article 
template must be set up to display these files, if users are to have access to them 



Polls 



* Polls 



+ Attach 



Favourite CMS [English) 



The Polls box enables you to add a specific reader voting poll to a specific article. Clicking the 
Attach button opens a pop-up window in which you can select the poll that you require. You 
can also create a new poll there. 

Other article types may contain different fields. Whenever you edit any of the fields, you will 
need to click either the Save All button at the top of the edit area, or any of the Save 
buttons in individual boxes. 

Note that date fields have a fixed syntax of YYYY-MM-DD (four year digits, two month digits 
and two day digits, in that order). If you enter dates in any other format, you may get 
incorrect results. 
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USING THE TINYMCE EDITOR 



The body field editor in Newscoop (a program called TinyMCE') allows contributors to perform 
extensive article formatting from within a web browser. You may be familiar with most of the 
functions of TinyMCE from using word processors such as Microsoft Word or OpenOffice.org: 
functions such as bold, italic, underline, and text alignment. Move your mouse over the icons 
to see a tooltip explaining what they do. Standard formatting keyboard shortcuts also work 
(e.g. ctrl+b for bold, ctrl+i for italic). 

Body 



b i urn iili|$fMI^XQ&lQa|<9 C|n|i ^Ldi 

miiL |Q| — A'^J-x, x' |i y := 1= | Styks HI P*"W*» H F«rt family - Fort size 




The editor field you see on your own Newscoop installation may look different than the one 
pictured above, depending on the extent of your user rights. Typically, the editor you'll see is 
the one that contains all the functionality you need for your site, but if you feel something 
vital is missing, discuss it with your Newscoop system administrator. 

There are two Newscoop-specific features in the editor. The first is Insert/edit internal link, 
which allows you to include links to articles within the same Newscoop publication, or within 
another publication on the same Newscoop server. 



ti'p "■ m ill 

Paragraph * Font t 


^ i # j a 


&t% ▼ Font size 





Clicking this icon opens a pop-up window with drop-down menus enabling you to select a 
specific language version of a publication, issue, section and article to link to. 
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® Orae^MDS MzmiM Otate - fctoMBs 0%Pfe @ (g ( 



(S) | http://newscoop-dev.sourcefabric.org/master/javascripV 



General 



-General prop 
Language 
Publication 
Issue 
Section 
Article 
Target 


>e roes 




English ^J 




the Custodian ^J 




issue 1 J 




Real Estate J 




Home Prices Rise i.1% in 3rd Quarter 


"31 




Open in newwindo* {_hlanlO 


d 







Insert 

Done 



After you click the Insert button, the internally linked text will be shown in blue and underlined, 
like a web link. 



Body 



HimL (I) — A ^2£ - X 2 X 1 I (ft !.-- B 
tf I - a I 3" ^ *• I 'm t,' T I 



This is the Jji]yycj= editor inside JfewsoMui . | 



The second Newscoop-specific feature is Newscoop Subhead, which allows you to break your 
text into different pages. (Your templates must be configured to use this option). 



!i|4 ' |n |£l & ^0J g 



Paragraph * Font famiry 



Font: 



Enter the text for the subhead into the editing window, select it with the mouse, then click the 
Newscoop Subhead icon. The subhead text will now be shown with a dashed outline. 

Body 



B 


I U ABC | 


^ 


= = 




II 


if 


HTIT1L 


HI — A^ 


gj - x a 


x- 


H 




A 


1 1 


— - 


I'm 


m ? 


T 


Thii 


is the TinyMCE 


editor inside Newsccoo. 




! Example subhead; 
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MANAGING CONTENT 



The "Article List" page is displayed when you enter a particular section via the Content menu, 
by following the hierarchy of publications, issues and sections. Alternatively, use the 
breadcrumb trail to jump to the section that you're interested in, and then click the "Go to 
Articles" link. 



DASHBOARD CONTENT ACTIONS 



Content > Publication: the Custodian > Issue: is suel (English) > Section: Real Estate > 



Article List; Real Estate 



^ Section List ■#■ Add new article 











L_ — 


^i 




Search: 

Showing 
















1 to 5 of 5 entries - filtering from 102 re 


cords 
















□ 


Name 


Type 


Author 


Sta 


D 


Making the Most of a Small 
Apartment 


News Article 


Sarah Staffwriter 


Publish 


D 


Real Estate Agency Celebrates 
50th Anniversary 


News Article 


Douglas Are 1 lanes 


Publish 


D 


Open House at Fairfield Mansion 


News Article 


James Q. Reponer 


Publish 


D 


Local Neighborhood On The 
Comeback Trail 


News Article 


Douglas Arellanes 


Publish 



To edit a specific article, simply click on its Name, and you will be taken to the "Edit Article" 
page. A locked article is one that is being edited at that moment, as shown in the list by a 
pink background and a padlock icon to the left of its name. 
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Search: 

Showing ] 




cords 










. to 5 of 5 entries - filtering from 102 re 




















n 


Name 


Type 


Author 


Status 


D 


6 Making the Most of a Small 
Apartment 


News Article 


Sarah Staffwriter 


Submitted 


□ 


6 Real Estate Agency Celebrates 
50th Anniversary 


News Article 


Douglas Arellanos 


Publish with 
issue 


□ 


Open House at Fairfield Mansion 


News Article 


James Q. Reporter 


Publish with 
issue 


D 


Local Neighborhood On The 
Comeback Trail 


News Article 


Do ug las Are 1 lanes 


Publish with 
issue 


D 


Home Prices Rise 1.1% in 3rd 
Quarter 


News Article 


Douglas Arellanos 


Publish with 
issue 


Showing ] 


. to 5 of 5 entries - filtering from 102 re 


cords 














Display [ 








10 ^J records 





To find out who is editing an article and when it was locked, click on the article Name in the 
list. A page will open with the name of the editor, and buttons offering the options of unlocking 
or viewing that particular article. Using the View option means that you will not be able to 
overwrite another contributor's work while it is still in progress. 



ACTIONS CONFIGURE USERS PLUGINS 



lian > Issue: is suel [English) > Section: Cars > Articlle: August Street Cruise 

Article is locked 

The article has been locked by Petr Jasek [petr.jasek) 28 minute[s] ago. 



Unlock 






Cancel 



MULTIPLE ACTIONS 

The Article List allows you to perform other actions besides editing the article, and you can 
perform these actions on multiple articles at once. To perform an action on one or more 
articles, click the checkbox to the left of the article name. The articles you have selected wil 
be highlighted with a light blue background. 
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Search: 

Showing 


















1 to 5 of 5 entries - filtering from 102 records 






















□ 


Name 


Type 


Author 


Status 





El 


Making the Most of a Small 
Apartment 

Real Estate Agency Celebrates 
50th Anniversary 

Open House at Fairfield Mansion 


News Article 
News Article 
News Article 


Sarah Staffwriter 
Douglas Arellanos 
James Q. Rep oner 


Published 
Published 
Published 


D 


Local Neighborhood On The 
Comeback Trail 


News Article 


Douglas Arellanos 


Published 


D 


Home Prices Rise 1.1% in 3rd 
Quarter 


News Article 


Douglas Are 1 lanes 


Published 


Snowing 1 to 5 of 5 entries - filtering from 102 records 


















Display 










10 ^j records 





Now that you have selected the articles, go to the "Actions..." drop-down menu at the top of 
the list, and select the action you would like to perform: 



Select action 



Status: Publish 
Status: Submit 
Status: Set New 

Toggle: 'On Section Page' 

Toggle: 'Comments' 

Publish Schedule 

Unlock 

Delete 

Duplicate 

Duplicate to another section 

Move 

Making the Most of a Small 






D 
D 



Apartment 

Real Estate Agency Celebrates 
50th Anniversary 

Open House at Fairfield Mansion 

Local Neighborhood On The 
Comeback Trail 

Home Prices Rise 11% in 3rd 
Quarter 



Type Author Status 

News Article Sarah Staffwriter Published 

News Article Do ug las Are I lanes Published 

News Article James Q. Reporter Published 

News Article Do ug las Are I lanes Published 

News Article Douglas Arellanos Published 



Showing 1 to 5 of 5 entries - filtering from 102 records 












Display |~10 ^[records 



For example, if you select "Toggle: 'On Front Page" 1 , Newscoop will publish the selected 
articles on the front page of your publication. A small green pop-up window will confirm that 
the action has been processed. Some actions will take you to another page, because they 
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require further input from you. These actions requiring additional input include Publish 
schedule, Duplicate to another section, and Move. 

The article list also allows you to rearrange articles as they appear on your section page, if 
your template supports this feature. To move an article's position in the list, simply click 
anywhere in it's row, hold the mouse button down, and drag the row to the position that you 
require. The new arrangement of the articles is not finalized until you click the Save order 
button underneath the Article List. 

On the right hand side of the Article List are additional columns which relate to other 
functions, such as the number of comments posted on the article, or the number of readers it 
has had. In the upper right corner of the list is a Show / hide columns button which enables 
you to select the columns that you wish to view. 

SEARCH 

Newscoop includes another tool which provides an overview of content across all publications 
on the server. The Search feature is accessed via an entry on the Content menu, and has an 
interface somewhat like an Internet search engine. You can filter the search options according 
to a specific publication, issue or section. You can also filter by a number of other criteria, 
such as the author or publication date of the article. 





DASHBOARD 


CONTENT t 


ACTIONS t 


CONFIGURE 


USERS w 


PLUGINS 


Content > 


Search 



Filter 



All Publications 



Filter by... 
Publish date 
Published after 
Published before 

Creator [^ 
Status 
Topic 



3 



All Issues 



3 H 



Search: 



Showing 1 to &D of 60 entries - filtering from 10B records 



— 



□ 



D 



Name 

Local Neighborhood On The 
Comeback Trail 



Type 

News Article 



Author 



Douglas Arellanos 



Stal 



Publish 
issue 
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PUBLISHING ARTICLES 



As mentioned previously, an article in Newscoop can have one of four different states: New, 
Submitted, Published, or Publish with issue. When you create an article, the Status: drop- 
down menu at the top of the editing area is set to New by default. Once your article copy has 
been drafted and is ready for the editors to see, click on this drop-down menu and change the 
Status: to Submitted. 



Newscoop 



Edit 




View 













Actions... t] 




Status: New I ▼] 


Language 


English ▼] 






Status: Published 










▼ Locations 


Status: New Ur 










• Edit 















After changing the status to Submitted, the page will be reloaded, and a pop-up message will 
indicate that the change in status of the article has been saved. The editors will be able to see 
the fresh submission when they log in to Newscoop. Articles which are ready for editing are 
listed in the Submitted Articles view on the administrator Dashboard. 



Dashboard 



Add more widgets 



Submitted Articles 



O 



Showing 1 to 1 of 1 entries 



Name 



Type 



Author 



Status 



On Front 
Page 



6 Making the Most of a 

Small Apartment News Article 



Sarah Staflwhter Submitted No 



On 

Section 

Page 

Yes 



Showing 1 to 1 of 1 entries 



In addition, if their user accounts have been configured for notifications, an email will be sent 
to the editors to inform them about the new submission. 

Once the editors have made any required changes and are happy with the way the article 
reads and appears, they can publish the article by changing the drop-down Status: menu to 
Publish with issue. Again, the page will be reloaded, and a message will indicate that the 
article's status has changed. 
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Edit 




View 



Save and Close 




Language 



English t] 



t Publish Sc I Status: Submitted 
Status: New 



+ Add Event 



When an article status is set to Publish with issue it becomes visible on your public web site, 
as soon as the issue it belongs to is published. This feature enables co-ordinated publishing of 
complementary articles when a complete issue is ready for the public. You can check the 
publication status of a particular issue in the Issue List. If the issue in question has already 
been published, then new articles can be seen by the public immediately after their status is 
changed to Publish. 

The process is fully reversible, so you can unpublish articles on your site (or even change their 
status to New) as easily as you can publish them. Note that only authorized users are allowed 
to publish articles, so you will not be able to access this option if your system administrator 
has not granted you this permission. 

SCHEDULED ARTICLES 

You also have the option to publish (or unpublish) an article at a specific date and time in the 
future. You can do this from the Edit article page, using the Add Event button in the Publish 
Schedule box. 




Edit 




View 



Actions... t] Status: Submitted t] 



Language English t] 



▼ Publish Schedule 










+ Add Event 






— Itf — 





After clicking on Add Event, a pop-up window will appear with a calendar and a series of three 
possible actions for the date and time that you choose: Publish/Unpublish, Show on front 
page/Remove from front page, and Show on section page/Remove from section page. 
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L (English) > Section* Real Estate > Article: Making the Most of a Small 



Small A 



Schedule a new action 
















Date: 

Time: 

Publish: 


2011-01-20 


□ 




13 : 55 
Actions 






Publish J 














Front page: 


— 


d 














Section page: 


Show on section page 


d 


















Close 






' 

















Choose the date by clicking on the calendar, or enter a date code manually. Then enter the 
time for the event, and choose one or more actions to perform at the time you have chosen. 
After you click the Save button, the pop-up window will close, and the event will appear in the 
Publish Schedule box. 



Newscoop 



Edit 




View 



Actions,., 



d 



Status: Submitted 



- 



Language English w] 



» Publish Schedule 










+ Add Event 














2D11-0 1-20 13:55:00 K 

• Publish 

• Showcxi section page 











Once the event is created, the actions will be performed automatically for you on the date 
and at the time you specified. After the event time, the Status drop-down menu will change 
to Published, and the event will no longer be shown in the Publish Schedule box. 
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18 



PUBLISHING AN ISSUE 



You can draft and edit articles for a particular issue on your Campsite server without any of 
the material being available to the public. You can then publish an entire issue all at once, and 
there are two ways to do it: immediately, or by scheduling the issue to be published at a 
specific date and time in the future. Note that within an issue, you can publish or unpublish 
each article individually; for instance, to hide an article even if the issue it belongs to has 
already been published. 

PUBLISHING IMMEDIATELY 

To publish an issue straight away, click the Publish link for the relevant issue and language 
edition in the Publish Date column of the Issue List. 



DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Content > Publication: the Custodian > 



Issue List 



Publication List ■#■ Add new issue 





Number Name URL Name Publish Date Configure Translate Previev 

(click to see sections) (YYYY-MM-DD) 


2 i S .ue2 (English) iss Le 2 p™^™,* % ■ Q 
2 n, mer o2 ( Espancn nu mer02 g^"^ % M Q 

i iS suei M issuci ;s?s % m cx 

1 n^roltEspanc,, nu^erol j™™" % U Q 







A pop-up dialog will ask you to confirm that you want to publish the issue in question, because 
this action implies that any articles which are part of the named issue will become available to 
the public instantly. 



r ® tjutj© \pm& -i£ Go^§$ft^ ***m (M 


^^, Are you sure you want to change the issue 2, issue2 
^^ (English) status from 'Not published' to 'Published'? 






Q Cancel 




<3ok 















After clicking the OK button, the issue will be published, and the Issue List will be updated 
with the publication date and time of that particular issue. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Content > Publication: the Custodian > 



Issue List 




^ Publication List + Add new issue 












Number Name URL Name 

(click to sec sections) 


Publish Date 

(YYYY-MM-DD) 


Configure 


Translate 


Previev 


2 issue2 [English] issue2 


2011-01-20 15:54:01 
Unpublish -Schedule 


^C 


01 


Q 


2 numero2 [Espanol] nurmero2 


2010-09-27 09:14:15 
Unpublish -Schedule 


M> 


LSI 


<x 


1 issuel [English] issuel 


2009-03-27 15:54:37 
Unpublish -Schedule 


% 


L£] 


a 


1 numerol [Espanol) numerol 


2010-09-27 09:14:39 
Unpublish -Schedule 


^C 


LSJ 


q 



To reverse the process, click the Unpublish link. Again, a pop-up dialog will ask if you are sure 
you want to change the issue's status. 

SCHEDULED PUBLISHING 

To schedule an issue to be published automatically at a specific date and time in the future, 
click on the Schedule link for the issue and language edition you require in the Publish Date 
column of the Issue List. This will open the Change issue details page, where you can set 
the date and time for this particular issue to be published. Over on the right hand side of the 
page are the Issue Publishing Schedule and Schedule a new action boxes. 



Issue Publishing Schedule 



Date/Time Action Publish articles Delete 



No events. 



Schedule a new action 








Date: 

Time: 

Action: 


2011-01-20 


□ 


16 




15 






Publish ; tI 












Publish articles: 


Yes^ 






H 









Click the small calendar icon to the right of the Date: field to select a specific day for 
publication. Set the time you require, and select either Publish or Unpublish from the drop- 
down Action menu. Then click the Save button. The Issue Publishing Schedule box will 
update to display the newly scheduled action. 
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Issue Publishing Schedule 
Dateffime 



Action Publish articles Delete 



2011-01-20 16:15:00 Publish Yes 



Schedule a new action 








Date: 

Time: 
Action: 


2011-01-20 


□ 


17 




00 






- d 












Publish articles: 


Yes J 
















Save 

















Note that you can also set the issue to be unpublished at a specific date and time in the 
future as well. This event will be displayed in the Issue Publishing Schedule box. 



Issue Publishing Schedule 






Date/Time Action 


Publish articles 


Delete 


2011-01-20 16:25:00 Publish 


Yes 


m 


2011-02-20 16:25:00 Unpublish 


Yes 


□ 



To cancel a scheduled action, click the corresponding white cross in a red box icon in the 
Delete column. You will be asked to confirm the deletion. 





/4^, Are y ou sure y ou wa nt t o del et e thi s sched u 1 ed a ct i on? 




Q Cancel 




49ok | 








kr 



If you click on the Date/Time link for a future event, the Issue Publishing Schedule page 
will open, and you will be able to edit the event. Click the Save button to confirm the schedule 
change. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Content > Publication: the Custodian > Issue: numerD2 [EspanoQ > 



Issue Publishing Schedule 



^ Issue List ^ Issue: numeral 



Edit 


Publis 




n 


Date: 2011-01-20 


Time: 16 : 50| 


Action: Publish jj 




h articles: Yes ^J 


^^^31 
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19. 



ARTICLE COMMENTS 



Reader comments can be switched on and off for a whole publication, for a particular article 
type, or for each individual article. You can also take advantage of Newscoop's management 
features to moderate (or bypass moderation for) comments from subscribers, or members of 
the general public. 

COMMENT SETTINGS IN THE PUBLICATION LIST 

To set the default comment setting at the publication level, go to Content on the main 
navigation menu, and then click Publications. In the Comments enabled column of the 
Publication List page which appears, publications in which readers can post comments are 
shown with a green light icon. Click on the Configure icon for the publication you wish to 
enable or disable comments for. 




Default Language Comments enabled URL Type Configure Delete 



English 



short names 



u 



This action opens the Configure publication page. In the Comments section, there is a 
checkbox labeled Comments enabled? and a variety of options which enable you to fine-tune 
comment settings. 



Comments 








Comments enabled?: 


© 




Article comments default to enabled?: 


© 




Subscriber comments moderated?: 


D 




Public allowed to comment?: 







Public comments moderated?: 







Use CAPTCHA to prevent spam?: 
Moderator Address: 
From Address: 


© 
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COMMENT SETTINGS FOR ARTICLE TYPES 

Perhaps you want to enable comments for all articles of a particular type, for example 
review_article, but not enable them for another type, such as news_article. Click Configure in 
the main navigation menu, and then click Article Types from the submenu. On the Article 
Types page which appears, clicking the red or green light icon in the Comments enabled? 
column toggles the setting for each article type. 




Configure > 





Article Types 






■it 1 Add new article type ^f Merge types 


S^ Show display names 




Template Type Name Fields Display Name 


Translate Show/Hide Comments enabled? 




n e ws_arti cl e Fields News Article [e n) 


"■ • % 




review_article Fields review_article 


P • • 



After you click on a green light icon, you will be asked if you are sure you want to deactivate 
comments for that article type. 



Lfe \pM& d 



ifcfe^i^ m 



Are you sure you want to deactivate comments for article 
type , news_article , ? 



©Cancel <j9oK 



COMMENT SETTINGS FOR INDIVIDUAL ARTICLES 

Comments can be enabled or disabled for a number of individual articles at once, using the 
Article List page. Click Content on the main navigation menu, then use the submenus to 
navigate to the publication, issue and section that you require. In the Article List page that 
appears, use the checkboxes in the left side column to select the articles you want to enable 
or disable comments for. Then use the drop-down Actions menu and click on Toggle: 
'Comments'. 
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DASHBOARD CONTENT 



ACTIONS CONFIGURE USERS PLUGINS 



Content > Publication: the Custodian > Issue: issuel [English] > Section: Real Estate > 



Article List: Real Estate 



^ Section List + Add new article 

Select action 



Status: Publish 
Status: Submit 
Status: Set New 
Toggle: 'On FrontPage' 
Toggle: 'On Section Page' 



& 



Publish Schedule 

Unlock 

Delete 

Duplicate 

Duplicate to another section 

Move 

a Making the Most of a Small 



□ 







Apartment 

Real Estate Agency Celebrates 
50 th Anniversary 



(7) Open House at Fairfield Mansion News Article 



□ 



© 



Local Neighborhood On The 
Comeback Trail 

Home Prices Rise 1.1% in 3rd 
Quarter 



Type Author Sta 

N e ws Arti cl e Sarah Staffwrite r Submit 

NewsArticle DouglasArellanes Publish 

James Q. Reporter Publish 

NewsArticle DouglasArellanes Publish 

NewsArticle DouglasArellanes Publish 



Showing 1 to 5 of 5 entries - filtering from 101 records 



If the publication or article type that the articles belong to have comments disabled, then 
enabling comments for those individual articles will have no effect. 
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20 



MODERATING COMMENTS 



To prevent spam or defamatory posts from appearing in your online publication, it's often 
necessary to moderate comments from readers before they are published. A CAPTCHA can 
prevent some automated spam, but it cannot prevent spam being entered into your 
publication's comment form manually. 



Comments 
Your comment 
Your name (mandatory): 
Your e-mail (mandatory)] 
Comment subject: 
Comment text 



A.N. Other- reader 



an@example.com 



I told you so! 



A cork on the end of the foil, 
that's the only way to make 
fencing safe. 




CUXIX| 



If you have configured your publication so that subscriber or public comments are moderated, 
the reader will see a message indicating that their comment has been sent for approval before 
it will be published - or not, as the case may be. 
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Comments 
Your comment 



Your comment has been sent for approval. 



Your name (mandatory): 
Your e-mail (mandatory): 
Comment subject: 
Comment text 



I told you so! 




The list of reader comments can be found by clicking Content, then Comments, on the main 
navigation menu. On the left hand side of the Comments page are two tabs; one for New 
comments, and one for Published comments. The New tab is the default, and beneath this 
any new comments are listed. The default list length is 20 comments per page. There is a 
Search field to help you find a specific set of comments, perhaps on a topical subject. Search 
results can be sorted by Date posted, Article name, Author or Thread, using the drop-down 
menu to the right of the Search field. The sort direction can be changed by clicking on the blue 
arrow icon next to the drop-down menu. 



DASHBOARD CONTENT ACTIONS CONFIGURE r USERS PLUGINS 



Content > 



Comments 

Hew(l) Published {?) 
Items per page 



:: 



Search: 



Date posted ▼] JL 



Search 



Date posted 



Subject 



Article 



1 20II-CI-20 I7:3I:Gfl I tcld yc-u Freak Fencing Accident Causes Calls far Greater Safety in ^ 
se! Spert ^ 



♦ 



Article: 
(f^Sho 



On the right-hand side of the Comments page is an area displaying the text and metadata of 
the current comment under review, as indicated by the small yellow arrow icon in the 
comment list. 
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(i) New O Approved Q Delete Q Hidden Q Ban user 



Save 



Article: Freak Fencing Accident Causes Calls for Greater Safety in Sport 
Gi Show article 

Date: 2011-01-20 17:31:03 

Author: A. N. Other-reader < an@example.com> 

Subject: 



I told you so! 



Comment: 



Acorkonthe end of the foil, that's the only way to make fencing safe! 



A row of radio buttons above the comment text enable you to update the New comment's 
status to Approved, or Delete if it is spam. Alternatively, the comment can be Hidden, or 
click Ban user to the user that made the comment banned from commenting on the 
publication in future. Clicking the Show article link, next to the magnifying glass icon, enables 
you to see the comment in the context of the original article. You can also click on the Article 
name link to open the Edit article page for that particular story. 
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21. 



SYSTEM PREFERENCES 



The System Preferences page is accessed via Configure in the main Newscoop navigation 
menu. 



DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Dashboard 



Add more widgets 



Most Popular Articles 



Showing 1 to 53 of 53 entries 



Templates 

Article Types 

Topics 

Languages 

Countries 

Localizer 

Logs 



This page allows you to control some advanced aspects of your Newscoop server, so it is 
recommended that access is reserved for administrators only. 

GENERAL SETTINGS 

The first section of the System Preferences page is for General Settings. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > 



System Preferences 



General Settings 

Site On -Line: 
Site Title: 

Site Meta Keywords: 
Site Meta Description: 
Time Zone: 

Database Cache Engine: 
Template Cache Handler: 
Imagecache Lifetime: 
Allow password recovery: 
Secret Key: 
Session Lifetime: 
Keyword separator: 

Number of failed login attempts before showing GAPTCHA : 

Maximum upload file size: 

Enter a value between and 2M (the maximum size is specified 
in 'php.ini). Please use "K" for kilobytes. 'M' for megabytes and 'G' 
for gigabytes, without white spaces between the value and the 
cones pon cling letter, e.g. '3M'. 

SMTP Host 
SMTP Port: 



® Yes O No 



The Custodian 



Newscoop. Sourcefabn'c. 



Newscoop -The open cor 



GMT+1J0O jj 



APC 



d 



DB jj 



1 Day tI 



® Yes O No 



1400 



: i 



localhost 



:~ 



Here is what each of the options means: 

• Site On-Line: These Yes and No radio buttons enable you to put the whole Newscoop 
server on-line or off-line, for example in case of scheduled server maintenance 

• Site Title: The default name for your publication's website. Your designer can configure 
your publication's templates to display this information 

• Site Meta Keywords: The default keyword meta tags in your header template, for 
search engine optimization 

• Site Meta Description: The default description meta tag in your header template, also 
for search engines 

• Time Zone: This field enables you to override the server's own time zone setting, which 
is typically set to Greenwich Mean Time (GMT). You may wish for your Newscoop 
interface to display local time instead, for instance when scheduling publication time for 

a particular issue 
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• Database Cache Engine: enables or disables the APC cache, which can improve 
Newscoop performance 

• Template Cache Handler: Select DB to enable the cache for templates 

• Imagecache lifetime: The time that images will be cached for, from 30 seconds to 
infinite 

• Allow password recovery: Whether users can get a password reminder by email. Note 
that if this feature is enabled and your email account is compromised, your Newscoop 
publication can easily be compromised in turn 

• Secret Key: The security key that Newscoop can use for integration of web services 
and other advanced features 

• Session Lifetime: Enables you to specify the maximum duration of Newscoop 
administration sessions without re-authentication, which is a security feature 

• Keyword separator: Specify the separator for Keywords in the Edit Article page 
(comma or hyphen) 

• Number of failed login attempts before showing CAPTCHA: A security measure 
designed to foil password-guessing robots 

• Maximum upload file size: The maximum size of attachments that users of your 
website can upload 

• SMTP Host: The server that Newscoop will use for sending out email notifications 

• SMTP Port: The port number that Newscoop will use on the specified email server 

EDITOR SETTINGS 

The second section of the page is for Editor Settings, which refer to image handling. 



Editor Settings 
Image Resizing Ratio: 

Image Resizing Width: 

Image Resizing Height: 



100 



Vo 

pixels 

pixels 



Zoom enabled for images in article content? GJ Yes ® Mo 



v 



The fields in this section enable you to specify the default resize ratio, or default width and 
height, for images in articles. If the Zoom enabled for images in article content? radio 
button is set to Yes, readers can enlarge article images in your publication's pages by clicking 
on them. 

EXTERNAL SUBSCRIPTION MANAGEMENT 

The third section down is related to external subscription management software. 



Reader subscriptions managed externally? Qi Yes '*' No 



If you select the Yes radio button for the Reader subscriptions managed externally? option, 
the subscription management features in the Newscoop administration interface are hidden. 
The subscription data is still held in the Newscoop database, which your systems administrator 
will have connected to your third-party subscription management software. 
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DATABASE REPLICATION SERVER 

The fourth section enables you to set up Newscoop to operate on two servers at once, which 
is a safety feature in case of hardware or network problems. 



Setting up a Newscoop Replication Server? '••*•' Yes O Mo 
Newscoop Online Server Database 
Database Replication Host: 

DataBase Replication User: 
Database Replication Password: 
Database Replication Port: 



db.example.com 



db user 






Selecting the Yes radio button for the option Setting up a Newscoop Replication Server? 

displays four fields: 

• Database Replication Host: The name or IP address of the remote database server 

• Database Replication User: The user name to connect with on the remote server 

• Database Replication Password: The password to submit on the remote server 

• Database Replication Port: The port number to connect to on the remote server (the 
default port number is 3306) 

USING AN AIRTIME MEDIA LIBRARY 

The fifth section enables you to attach media located in an Airtime storage server to articles 
in your Newscoop publication. Once you've installed and configured Airtime, create a user in 
the Airtime administration interface and add it to the Admins group. Back in the Newscoop 
System Preferences page, select the Yes radio button for the option Enable Airtime audio 
attachments? 



Enable Airtime audio attachments? 
Air lime Server 
Hostname / IP Address: 

Port: 

XML RPC Path: 

XML RPC File: 



® Yes O No 



localhost 






/airtime/sto rage Sen/a 



xrLocStor.php 



Below, you should enter the host name or IP address of the Airtime server. The values of the 
fields Port, XML RPC Path and XML RPC File should already be filled in with the default values. 
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You don't need to edit these default values, unless you have a custom Airtime configuration. 

The last step is to give certain users the right to attach audio files to articles. You can edit a 
Staff User Type to enable this, so that all users of this type will receive the right 
automatically. Alternatively, you can enable this right for individual staff user accounts. 

TEMPLATES FILTER MASK 

Enter keywords for templates that you wish to hide on the Configure -> Templates page. For 
example, templates that are no longer in use, but you do not wish to delete from the server 



Templates filter mask (separated by comma) 



*,CVS| 



CRON TASKS 

Run cron tasks externally? means to use the server's own scheduler for automated tasks, 
rather than the one included in Newscoop. 



Run scheduled tasks externally? ® Yes O No 



GEOLOCATION SETTINGS 

This section enables you to specify how maps linked to articles will be displayed, and which 
Internet mapping service will provide the data. 
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Geolo cation Settings 

Map Center Latitude: 

Map Center Longitude: 
Map Zoom Level: 
Map Default Width: 
Map Default Height: 



Allow Google Streets Map Provider: 
Allow MapQuest Map Provider: 
Allow OpenStreet Map Provider: 
Default Map Provider: 



Map Marker Directory: 
Map Marker Default: 



Map Popup Minimal Width: 
Map Popup Minimal Height: 



50.069926 




14.424133 






4 




600 




400 





V 
• 



Google Sireets Map j ▼] 



/javascri ptfgeocod i ng/ma 



marker-go Id. png t] 



300 



:: : 



VIDEO SETTINGS 

The default width and height of both externally and locally hosted video files can be set in this 
section, to make sure that the videos are displayed correctly in your publication's page 
templates. 
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Youtube Default Width: 
Youtube Default Height: 



425 



350 



Vimeo Default Width: 
Vimeo Default Height: 



Flash Default Width: 
Flash Default Height: 
Local Flash Server: 
Local Flash Directory: 



400 
225 



425 



350 



videos/ 






Finally, the Save button updates your preferences. 
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22. 



TEMPLATES 



Templates control the look and feel of your Newscoop publication. Each publication has a 
unique set of templates created by your web developer, which should have already been 
installed by your system administrator. The Newscoop administration interface includes a 
template management and editing tool, which you can find by clicking Configure on the main 
navigation menu, then Templates. 



DASHBOARD CONTENT ACTIONS 



Dashboard 



Add more widgets 



Most Popular Articles 



Showing 1 to 53 of 53 entries 



CONFIGURE 



USERS PLUGINS 



System Preferences 

Article Types 

Topics 

Languages 

Countries 

Localizer 

Logs 



Templates are organized into folders, shown in a box on the left hand side of the page. 



DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > Templates > Path:/ > 



Templates 


+ 


Create new folder ■# Create new template □ 


Upload template 






Actions... t] 


Select All 




Select None 


















Folders Delete 




Files Template ID Cache lifetime, sec 


Du| 


L-J classic ™ 


□ J get-rss.php SS6 


B feed * Q 








t— J systemjem plates ™ 

















Clicking on the name of a folder shows the files included in that template. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > Templates > Rati:/ classic/ > 



Templates 



□ Go up c 3 a Create new folder E 3 a Create new template □ Upload template 





Actions.., 


d 










Folders 


Delete 




I > CSS 


□ 




I — I img 


□ 




Q, 


□ 




Dtpi 


□ 





Select All 



Select None 



Files 



Te m p I ate I D C ach e I if eti m e . sec D uplicate 



Q J archive.tpl 167 

□ J article.tpl 173 
U J index.tpl 172 
D J register.tpl 1GB 

I _J search -re sulLtpl 169 

D _] sectional 171 

□ J topic.tpl 170 



In turn, clicking on a file name opens that file in the template editor. This feature enables web 
developers to make quick changes to templates on a running Newscoop system. 



DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > Templates > Rati:/ classic/ > 



Edit template: article.tpl (Template ID: 173) 









Edit template: 


classic/article Jpl t] 











Replace c 



n © 



I 10 pt ^ |5marty Tj J <Q_ g 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 



|{ include file="classic/tpl/header.tpl" }| 

^body id-article" class="5ectiori-{{ $gimme->section->riLimber }}' 
<div id="container ll > 
<div id= M wrapbg M > 
<div id="wrapper"> 

{{ include files' classic/tpl/headernav.tpl" }} 

<div class="colmask rightmenu"> 
<div class= M colleft"> 
<div class="collwrap"> 
<div class="call"> 



You should only make changes to the templates if you know what you are doing, because any 
modifications will have an immediate impact on the appearance of your publication. This 
feature is also useful for editing templates on a development server before they are copied to 
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the publication's production server. 
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23. 



ARTICLE TYPES 



Article Types specify the information that Newscoop will require from the journalists adding a 
particular kind of article to your publication. For example, a feature story is likely to require 
more elements than a brief news item. By default, Newscoop has one Article Type set up, 
which is News Article, but you can create as many as you need. To create or manage your 
Article Types, select Configure, then Article Types from the main navigation menu. 





DASHBOARD CONTENT ▼ ACTIONS ▼ 


CONFIGURE USERS ▼ 


PLUGINS 






System Preferences 
Templates 

Topics "* 

Languages 

Countries 

Localizer 

Logs 




Dashboard 






Add more widgets 






Most Popular Articles 












Showing 1 to 53 of 53 entries 











This action opens the Article Types page. Article Types consist of a sequence of fields, with 
each field holding a certain kind of data. Currently, there are six kinds of fields available: 

• Single-line text: this type of field can contain a maximum of 265 characters, and does 
not support HTML tags. Its appearance and character set is entirely determined by the 
template in use 

• Multi-line text with WYSIWYG: this type of field can be up to 16MB in size. The 
journalist can insert images, audio, video, links (external, internal or to attached files), 
and formatting tags. Subheads can be used for article pagination 

• Date: this is a standard date field with a fixed syntax of YYYY-MM-DD (four year digits, 
two month digits, two day digits, separated by hyphens) 

• Topic: this type of field can be used to categorize articles. Each topic field has a top 
level element, for example Entertainment / Review. When the journalist types the article 
into Newscoop, this field will display a drop-down menu containing available subtopics of 
that top element, such as Movie Review or Theater Review 

• Switch: allows you to add check boxes which activate particular features to the Edit 
Article page. For example, you might add a switch breaking_news, which would be used 
by your template to display the article in a special place on your site. (Newscoop comes 
with two switches by default, Show article on front page and Show article on section 
page) 

• Numeric: allows you to add numeric elements to your articles, such as 
longitude/latitude, temperature, or exchange rate 

Newscoop makes a distinction between the Template Name and Display Name for each 
Article Type and field. The Template Name is limited to letters, numbers, and underscores (no 
spaces) and is used internally by your Newscoop template. The Display Name is the part that 
the journalist will see, and can be translated into other languages. 

ADDING A NEW ARTICLE TYPE 

Click the Add new article type link at the top left of the Article Types page. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUG INS 


Configure > 


Article Types 




■tt 8 Add new article type ig Merge types 6^ Show display names 




Template Type Name Fields Display Name Translate Show/Hide Comments enabled? 


new5_article Fields News Article [en) |.*J 







The Add new article type page will appear. The first step is to enter the Template Type 
Name of the Article Type you wish to create. In this example, we'll create an Article Type 
with the template type name review_article - note that it has an underscore, instead of a 
space, between the words review and article. 



DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > Article Types > 

Add new article type 



Add new article type 



The template name may only contain letters and the underscore (_) character. 
Template Type Mame: 



review_article| 



^^H| 



After you click the Save button, you will be prompted to enter the Template Field Name of 
the first field in the new Article Type. Select one of the six field Types available from the 
drop-down menu, for example Topic. For this particular field type, we'll also have to select a 
top level element, such as Entertainment / Review. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > Article Types > review_article > Article type fields > 



Add new field 



The template name may only contain letters and the underscore (__) character. 


Template Field Name: 


reviewjopic 












Type: 


Topic t] 










Top element: 


Ente rtain me nil Review |tI 




BB 



After clicking the Save button, the Article type fields page is shown. The Article Type that 
you are currently working on is shown in the breadcrumb trail beneath the main navigation 
menu. 



DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > Article Types > review_article > 



Article type fields 



^ B ac It to A rtic le Type s List 

^ Add new field G^ Show dis play Jiames 



Order Template Field Name Type 



Display Name Translate Is Content Shoi 



reviewjopic 



To p i c (R e vi ew) re view jo p i c 



N.'A 



Click on the Show display names link to add a Display Name for this new field. Select the 
language you require from the Add translation drop-down menu, and enter the display name 
for the new field in this language. Then click the blue Translate button. 
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Configure > Article Types > review_article > 



Article type fields 




^ B ac h to A rtic 1 e Type s List 

=5= Add new fie Id fc^ Hide display names 




Order Template Field Name Type Display Name Translate Is Content Shot 


reviewjopic Topic (Review) reviewjopic N/A 














Add translation: 


English t] 




Review Topic] 



















The Article type fields page will now show the Display Name for the field, together with a 
language code (in brackets) to indicate its translation. Note that the Display Name can contain 
spaces, or be capitalized differently from the Template Field Name. 



DASHBOARD 



CONFIGURE 



Configure > Article Types > review_article > 






Article type fields 




^ Bac k to A rtic le Type s List 

E S a Add new fie Id Gj^ Show display names 








Order Template Field Name Type 


D is play Name Trans late 


Is Content S 




re vi ew_to pic To p i c (R e vi e w) 


Review Topic [en) | 


N/A 



Continue to add new fields to this Article Type, until you have all that you need. Then click the 
link Back to Article Types List, next to the blue arrowhead icon. This action will return you 
to the Article Types page. 

EDITING ARTICLE TYPES 

You can add translated Display Names for your new Article Type after clicking on the Show 
display names link in the Article Types List. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > 



Article Types 



_n_ W /^ 

■tP Add new article type "^ Merge types l^ Hide display names 



Template Type Name Fields Display Name Translate 


Show/H ide Com me nts e nable d? 


news_article Fields News Article [en] JisJ 


• • 




en News Article 


es articulo 


















Add translation: 


IK*£ jj 








Translate 




















review_article Fields review_article 


• • 














Add translation: 


English tI 




Review Article| 


^^^^^^9 












T> 





Article Types are not set in stone; they can evolve as your publication evolves. For example, 
you can hide old Article Types that are no longer in use. Toggle whether a type is shown by 
clicking on the colored light icon in the Show/Hide column - green for shown, red for hidden. A 
pop-up dialog will ask you if you are sure about this action. 



(g) UfeP (ftftgyp -ifi CifiSp^to^ £■!%££ Ijg]" 



Are you sure you want to hide the article type 'review article'? 



Cancel 48 OK 



Hiding a type is less dangerous than deleting it; the latter action will remove the associated 
content from the server. The delete button is a white cross in a red square icon, over on the 
right side of the page. Use this button with caution! 






Ill lil 

^jf Merge types 


Gj^ Show display names 






Fields Display Name 


Translate Shaw/Hide Comments enabled? 


Delete 




Fields News Article [en] 


P • • 


□ 


Fields review_article 


P • • 


* 











As usual when carrying out an action that will have an impact on your publication, Newscoop 
will ask you if you are sure. 
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® Tftj© [^f>l** -ii> [K^wte^W^ ^i£*S |£[f 


,4^ Are you sure you want to delete the article type reviewarticle? 
^P WARNING: Deleting this article type will delete all the articles 
associated with this article type. 






Q Cancel 




<$9ok 















In the Article Types List there is also a Comments enabled? column, which toggles readers 
comments on and off for a specific Article Type. For example, you might wish to disable 
reader comments for all entertainment reviews, but leave them enabled for news articles. 

Article types can be renamed, simply by clicking on the Template Type Name in the Article 
Types page. Remember that if you change a Template Type Name, you cannot put spaces 
into it. 



DASHBOARD CONTENT ACTIONS CONFIGURE 



USERS PLUGINS 



Configure > Article Types > 



Rename article type Yeview_article' 



The template name may only contain letters and the underscore (_) character. 
Template Type Name: reviews|_article 






EDITING ARTICLE TYPE FIELDS 

On the Article Type Fields page, fields can be renamed, given Display Names, hidden or 
deleted, just like Article Types. When you have more than one Article Type field, you can re- 
arrange the order in which the fields show up on the Edit article page by clicking the blue up 
and down arrows. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > Article Types > review_article > 



Article type fields 




^ Bac k to A rtic 1 e Type s List 

+ Add new field S^ Show display names 








Order Template Field Name Type Display Name 


Translate 


Is Corn 


\J reviewjopic Topic (Review) Re view To pic [en) 


m 


N/A 


W W show_name Single-line Text Name of Show [en) 


m 


N/A 


4^ star_rati ng Numeric Star rati ng o ut of five [e n) 


p] 


N/A 











To change a field type, for example, from Single-line Text to Multi-line Text with 
WYSIWYG, click on the corresponding link for that row in the Type column. The Reassign a 
field type page will open, on which you can select the new type from a drop-down menu. 
Then click the Save button to return to the Article type fields page. 



DASHBOARD CONTENT ACTIONS 



CONFIGURE USERS PLUGINS 



Configure > Article Types > review_article > Article type fields > 



Reassign afield type 



Type: 



Multi-line Text with WYSIWYG 



• 



S- 



After editing article type fields, you could create a new article to test that the updated fields 
are displayed as expected. 
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Content > Publication: the Custodian > Issue: is s uel [English] > Section: Lifestyle > Article: Movie Night [I 



Movie Night 



Date 

Created: £011-01-21 17:49:40 □ Last modified : 20114)1-21 17:49:40 

Review Topic 



Ente rtai n me nt i Review i Movie Review ▼] 



Name of Show 






















b i u «e m 

HTM. B A - & • 

M | e a 1 1° ^ 


' x, X" | ift 

^ 1 'm m' 


«. 1 .= 

T la 


1% x aiti 1 ? 


(* 


in 


ifi 


X 


|E ; Styles 


Format 




HI 


Font family 


IS 













Henry Platter and the Suitcase of Cash 



Path: 



Star rating out of five 



1.5 



MERGING ARTICLE TYPES 

Newscoop enables you to merge two different Article Types so that content in fields from 
one type (the Source Article Type) is migrated to another (the Destination Article Type). 

This is a useful process to go through after adding or editing an Article Type, so that all 
previously written copy matches the new Article Type fields. 

On the Article Types page, click the Merge types link. This opens the Merge article type 
page. Select the source and destination Article Types you wish to merge from the drop-down 
menus. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > Article Types > 



Merge article type 










Merge Article Types: Step 1 of 3 




Source Article Type Destination Article " 


TYpe 




review_artjcle ▼] 




news_artjcle wj 






1 


3E 


m. 











Next, choose the fields of the source which you'd like to merge into fields of the destination. 





D/ 


\SHBOARD 


CONTENT 


AC" 


riONS 


CONF 


IGURE 


USERS - 


PLUGINS 



Configure > Article Types > 



Merge article type 



Merge Article Types: Step 2 of 3 



There are 1 articles associated with Review Article that will be merged. 

Source Article Type Destination Article Type 

Review Article -> News Article 

Deck 

Lead and SMS 

Body 



Review Topic 



]- 



Name of Show 



• 



Star rating out of five t| 



Back to Step 1 



The next screen displays the result of the potential merge. Any source fields which have not 
been mapped to destination fields are shown in a red font. You may need to create additional 
fields in the destination Article Type before attempting the merge again. 

You can cycle through all the articles which will be merged, and preview the changes. 
Optionally, check the box to Delete the source article type. When you're ready, click the 
Merge button. 
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DASHBOARD CONTENT ACTIONS CONFIGURE USERS PLUGINS 



Configure > Article Types > 



Merge article type 



Merge Article Types: Step 3 of 3 



Merge configuration for merging Review Article into News Article. 

Merge reviewjtopic into Deck 

Merge show_name into Lead_and_SMS 

Merge star rating into body 

(!) Do NOT merge conclusion (No merge warning.] 

Preview a sample of the merge configuration. Cycle through your articles to verify that the merge configu 

Preview of Movie Night (View the source (Review Article) version of Movie Night) 1 of 1. 
This is the first translation of 1 



Name: Movie Night Created by: Daniel James 

Type: News Article Creation date: 201H31-21 17:49:40 
Number: M Publish date: 000CMKMK) 00:00:00 



Show article on 
Show article on 
Allow users with 



Keywords: teen, wizard^ franchise 
Deck: 41 
Lead and SMS: 



Henry Plotter and the Suitcase of Cash 



Body: 1-5 



llDelete the source article type (Review Article) wnen finished. 



Clicking "Me 



Back to Step 2 






If there are no articles left belonging to the Source Article Type, Newscoop will display a 
warning message at the first step of the proposed merge. 



ACTIONS CONFIGURE USERS PLUGINS 



Configure > Article Types > 



Merge article type 


Merge Article Types: Step lot 3 


The source article type (review_article) dees net have any articles. 




OK 
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24. 



TOPICS 



In Newscoop, topics are the subject matters assigned by editors and journalists to articles, so 
that related articles can be identified and displayed together. A topic can have many 
subtopics; for example: the sports topic could have the subtopics football, basketball, and 
water polo. An individual article may have several topics or subtopics assigned to it. 

To review or create topics, click Configure on the main navigation menu, then click Topics 
from the sub-menu. 




To add a new top-level topic, select a language from the drop-down menu and enter a word in 
the Add root topic field. Then click the Add button. 



Configure > 



Topics 



Show languages 



Select All 



Select None 



en □ de □ pt □ fr H es D ro □ hr □ cz □ sh □ sr D in D sv D zh D ar D 



Search 



Search 



Add root topic 



English 



jj Travel| 



■1 



\+\ en Weather 



[+]esTiempo 



/ Edit X 
/ Edit X 



To rename a topic, click the Edit link to the right of the topic or subtopic name. The name 
row will expand to show the Change topic name field. Update the name, and then click the 
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Save button. 



II enTrave 


1 S Edit x 










|i Q en Weather / Edit X 




1 EjesT 


ie 


mpo / Edit X 












III E 
III E 


]en Storms / Edit x 




]esTormentas • Edit x 










II en Freak Weather / Edit X 
















Change topic name 










Freaky Weather] 


^^M 








T^ 


















Add subtopic. 








English 


Add 


































—Select language— wj 




Translate 














III 


es 








i Lunatic o Tie mpo / Edit X 



You can translate topic names so that they appear in the correct language when an author is 
editing an article. To translate a topic, click the Edit link to display the Add Translation field 
for that topic name. Select the language you are translating into from the drop-down menu, 
enter the translation of the topic name, and then click the Translate button. 



en Travel 



/ Edit X 



\=\ en Weather 



Change topic name 



Weather 



/ Edit X 



Save 



Addsubtopic: 
English 



Add 



Add translation: 



Deutsch 



^J Wetter] 



j. 



[£]esTiempo 



S Edit X 



If you translate a subtopic and its parent has not yet been translated, the parent topic will 
appear in its original language until you translate it. 

To add a subtopic, click the Edit link next to the topic you want to put the subtopic under. 
Enter a word or two into the Add Subtopic field, then click the Add button. 
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I; en Travel 


• Edit 


X 














HI \+\ en Weather / Edit 


X 


















uiicuiye iu|jil iidi ic 












Weatner 


Save 
















Add sut 












topic. 










English 


Local| 










n> 


































—Select language— t| 




Translate 
























II [+]esTiempo • Edit 


X 













The new subtopic will appear underneath its parent topic. 



en Travel 



y Edit x 



□ en Weather 



QesTiempo 



\E 



en Local 
[+] en Storms 



[TjesTarmentas 



• Edit X 



/ Edit X 



• Edit x 



3 



^ Edit X 



/ Edit X 



en Freaky Weather 



es Lunatic o Hem po 



/ Edit X 



/ Edit X 



You can delete a specific topic or subtopic using the blue cross icon, on the right hand side of 
its row. If you attempt to delete a topic currently in use by an article, Newscoop will warn you 
about this. 



DASHBOARD CONTENT 



ACTIONS CONFIGURE 



USERS PLUGINS 



Configure > Topics > 



Deleting topic 



Deleting topic 



TTiere are 2 articles using the tcpic. 



■% 
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25. 



LANGUAGES 



While Newscoop's default language is English, you are by no means limited to publishing in that 
language only. Click Configure on the main navigation menu, then Languages from the 
submenu, to see the languages currently available on the system. 

Screenshot: 

E B J 

The Language page enables you to configure support for languages that you wish to publish in. 
The Code column refers to the two-letter ISO 639-1 code name for each language. English, for 
example, is en, German is de, Spanish is es, Chinese is zh and so on. 



Screenshot: 



m 



Click on a name in the Language column to open a page for that language, which enables you 
to adjust month, day and time name translations. This feature ensures that automatically 
generated publication dates and times for an article in a particular language are displayed 
correctly to your international readers. 



Screenshot: 



m 



To add another language, click on the Add new language link, next to the green cross icon. 
You should enter the language name (both in English and in the language itself), and its code 
(e.g. cy for Welsh). 



Screenshot: 



m 



After entering translations in all the fields, click the Save button at the end of the page. The 
new language will now be shown on the Languages page. 



Screenshot: 



m 



You may wish to limit the number of languages configured on your server, in order to spare 
your editors and journalists from having to navigate long drop-down language menus. To 
remove a language, click the white cross in a red square icon at the end of each row in the 
list. You will be asked if you are sure about this action. 

Screenshot: HI 
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26. 



COUNTRIES 



This page determines how country lists will appear in forms that readers fill in, for example 
when signing up for an email newsletter. It also enables you to create country lists in different 
languages. To see the list of country names in the default language, click Configure on the 
main navigation menu, then Countries on the submenu. 

Screenshot: 

The Countries page shows an alphabetical list of countries, with the language they are 
displayed in, and a two-letter ISO 3166-1 country code for each name. Note that the 
alphabetical sorting is by the country code, rather than by the country name. 



Screenshot: 



m 



Click on the name of a country to rename it, then click the Save button to return to the 
country list. 



Screenshot: 



m 



To translate a specific country name into a particular language, click the Translate link in that 
country's row in the list. In the Translate country name page, select the target language 
from the drop-down menu, and enter the translation into the Name field. Then click the Save 
button. 



Screenshot: 



m 



To find your translated country names later, use the drop-down Language menu at the top of 
the Country page to select the language you are interested in, and then click the Search 
button. The search results, if any, will be listed below the Search box. 



Screenshot: 



m 



Newscoop's list includes almost all known countries by default, but if you have deleted a 
country and need to put it back, you can do this by clicking on the Add new country link next 
to the green cross icon. You will be prompted to enter the country's two-letter ISO code, 
name and language. The drop-down menu will contain as many languages as you have defined 
in Newscoop's Configure - Languages page. 



Screenshot: 



m 



Note that the language you are asked to specify is the language in which you are entering a 
country's name, not the language spoken in the country. 
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27. 



THE LOCALIZER 



The default language for the Newscoop administration interface is English, but you can either 
use one of the many translations supplied with Newscoop, or create your own translation 
using the built-in Localizer tool. You can also use the Localizer to improve an existing 
translation, or adapt it for a regional dialect. 

The first step is to check that the language you wish to translate into is in the Configure - 
Languages list. If your target language does not exist yet, you will have to add it to Newscoop 
first. Then, you can open the Localizer by clicking Configure - Localizer on the main 
navigation menu. 

Screenshot: 

B J 

The Localizer works by enabling you to translate individual 'strings' of text that appear in the 
Newscoop administration interface. There are around 1893 strings in the whole of Newscoop, 
divided into 36 Screens representing the various different pages in the interface. You can 
complete a localization with a team of translators working together, by tackling one screen 
each at a time. 

Screenshot: 

M D 

Select your source (Translate from) and target (Translate to) languages from the drop-down 
menus, and then select a Screen, such as Universal List or Article Types. Strings that have not 
yet been translated are shown in a red font. You can save your work at any time by clicking 
the disk icon next to one of the input fields. When you have completed your translation, there 
is a Save button at the end of the page. 

Screenshot: 

M D 

You will encounter strings with a dollar sign in them, e.g. "$1". This means that one or more 
words will be substituted in place of these characters. For example, the phrase "Signed in: $1", 
when printed out on the interface, might be: "Signed in: Administrator". In this example, 
"Administrator" was substituted for "$1". 

TinyMCE, the WYSIWYG article editor incorporated into Newscoop, can also be localized. The 
strings in TinyMCE have to be edited manually by your system administrator, which is a task 
done separately from the Localizer. 

SENDING A LOCALIZATION BACK TO THE NEWSCOOP 
TEAM 

We actively encourage Newscoop users to send us their language localizations. This makes 
Newscoop more useful for people around the world. Even if a similar language localization 
exists, it may not address your particular needs or regional differences. For example, there 
may be differences in Spanish between that used in Spain and that used in Guatemala. In that 
case, you can localize Newscoop to your needs and share the localization with other users that 
speak your language or dialect. 

For more information on how to contribute a localization to Newscoop, please email 
contact(a)sourcefabric.org 
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28. 



LOGS 



The Newscoop administration interface includes a feature which enables you to keep track of 
who has done what, and when, on your publication's server. You can examine Newscoop's log 
files by clicking Configure on the main navigation menu, then Logs. 

Screenshot: 

E B 

The default log view displays all recent events on the Newscoop server, with 15 listings per 
page, and the most recent events first. Click the Next link or page number just above the 
search results box to see previous pages. Like most features in Newscoop, the Logs page is 
multilingual, so you may see log entries in languages other than your own. 

Screenshot: 

m z\ 

To examine the logs selectively, use the Event drop-down menu above the search results box 
to select a particular action; for example, Add Article. Then click the Search button, and the 
Logs page will be refreshed to list events corresponding to that action exclusively. 

Screenshot: 

■ 
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29. 



USER MANAGEMENT 



Newscoop's user management allows you to control access to the back-end and the front-end 
of your publication. Back-end users are called Staff users and front-end users are called 
Subscribers. You can define roles for your staff members, such as Journalist and Editor. The 
interface will change for each user depending on which permissions they have enabled. For 
example, a journalist will have a more simple interface than an editor. 

Your subscribers are most likely paying for access to your content. When you edit an article, 
you have to option to make the article only viewable to subscribers. 

Initially, Newscoop has only one user account: admin. Do not delete this user, as it is needed 
by the email script which informs Staff users of events in the system. The email address of 
"admin" after installation because it is used as "Reply-To" address in the notification emails. 

CREATING USER TYPES 

A user type is generally defined by the list of the tasks a user is allowed to do in a system. In 
Newscoop, this list of tasks ranges from creating, managing, and editing publications, sections, 
and articles, to template management and definition of the publishing environment. 

To simplify user management, Newscoop allows you to create generic user types, which can 
then be assigned to multiple users, instead of taking care of every single access right for every 
single user. 

Newscoop comes "out of the box" with three default user types: 

• Administrator - user with full authorization, i.e. all rights (normally reserved to 
webmasters) 

• Chief Editor - user with higher editorial rights (e.g. has a right to create and delete 
issues) 

• Editor - standard back end user with rights limited to basic article management and 
editing (normally assigned to journalists and editors) 

To create your custom user profiles, select 'Users' - 'User types' from the main menu: 
Screenshot: IH 

and then select Add new user type'. Proceed to select the rights that you want included for 
this type of user. 

CREATING STAFF USERS 

To add a user, select Users->Staff from the main menu: 

Screenshot: IB 

and then choose 'Add new user account'. You will see this page: 

Screenshot: IB 

You should specify the full name of the user, user name, password, and choose a predefined 
user type (i.e. one of the default types or your custom user types). 

If you would like to further fine tune the rights assigned to a particular user, go to Users - 
104 



Staff and click on the user name you wish to edit. 
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30. 



SUBSCRIPTIONS 



Newscoop allows you to control public access to your publication through its built-in 
subscription module. (If you want to have all your content freely accessible, you can bypass 
the subscription feature in your templates.) 

All articles that you create in your publication are available to subscribers only by default. 
Publication editors or administrators have the right to make an article accessible to non- 
subscribers. 

The way it works from the readers' side is as follows: If a reader tries to access a non-public 
article, she is informed that she is not allowed to read the article but is provided with an 
option to subscribe immediately to that article, other articles, or the whole publication. A 
temporary subscription is activated immediately (the duration of that temporary subscription 
is determined by the value you set for the 'Pay Time', For more information, see the "Creating 
a Publication" chapter). During this period, the reader has a chance to effect the payment and 
consequently have her subscription extended by the administrator. 

The publication's administrator is automatically notified of all new subscriptions by e-mail. 
Subscribers also receive automatically generated e-mail reminders that their subscription is 
expiring 14 days before the event. 

The text of the subscription-expiry message is hard coded in the current version of Newscoop 
and it reads as follows: 

"Dear <reader>, 

This is an automatically generated e-mail message. Your <subs_type> subscription (started on 
<start_date>) to publication <publication> will expire on <date> (in <number> days). 

Please enter the site http://<pub_site>: to update subscription." 

Future versions of Newscoop will allow for customization of the message and for its translation 
into multiple languages. 

Newscoop allows you to control access to your site in two ways: 

• Standard UserName:Password pairs, which is suitable for individual users 

• IP Address access, which most institutional subscribers (libraries, universities, NGOs, 
companies, etc.) tend to prefer 

As Newscoop handles subscriptions at the publication level, all subscription-related variables 
are customizable from the Publication Configure screen: 



Screenshot: 
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First you have to select a time unit for your subscriptions; the time unit can be: days, 
months, weeks or years. 

You can set two types of subscriptions: paid and trial. Paid subscriptions have the following 
properties: 

• Currency: the publication's currency. Even if the subscription request is sent and the 
currency is changed meanwhile, the information about the user's debt is correctly 
recorded. 

• Time unit cost per one section: 
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o for one language: the price for access to a section in a single language 
o for all languages: the price for access to a section in all available languages 
• Default time period: the default duration of the paid subscription. This value is used 
when a reader subscribes through the front-end (site). The period for a certain 
subscription can be modified from the administration (back-end) interface. 

You can specify different default time periods for individual countries if you like. To do so, click 
on "Countries defaults". You will then have the option to "Add new country", and create 
subscription preferences for a given country. 

Username/Password Access 

Newscoop allows readers to subscribe to one publication at a time. Within a publication itself, 
the level of subscription is the section. The reader is able to select any section from the list of 
the publication's sections, and for each of them specify the period of time he would like to 
have a subscription for. 

Before submitting his request, the user (reader) can evaluate the cost of the subscription and 
change it. At any time later, he can subscribe to additional sections. Once the user has 
subscribed to a section, he can't increase the period of time for the subscription until payment 
is made for that section. 

Immediately after the completion of the subscription form, the reader has the right to view 
the site. By default, the reader has seven days to make a payment and have his subscription 
confirmed by the administrator, or else the account is locked. 

The authorized person can confirm the payment, so that the subscription remains active after 
the first seven days. There are two options in the administration module for that: change the 
value of the amount that the subscriber has to pay, or change the number of days the 
subscriber is allowed to view the publication's site. By default, if this value is set to zero, the 
number of paid days is automatically set to the number of requested days. 

The administrator (or any other user who has the rights to manage publications) has seven 
days to confirm the payment. The confirmation is made from the main menu, by selecting 
User and then Subscriptions. The confirmation consists in changing the payment status (from 
'no' to 'yes'). 

IP Address Subscriptions 

The IP based access can be used to automatically log in users that have known IP addresses 
that never change. Examples of this are libraries, colleges, or schools. The IP address-based 
access works by recognizing a computer as owned by a certain subscriber based on the 
computer's IP address. Subscribers with IP address-based access will be allowed to accesss the 
site without being prompted for user names and passwords. 

To create an IP Address subscription, go to the Subscribers page: 

Screenshot: IH 

You will see a page that looks something like this: 

Screenshot: 

M ~J 

First create a regular user by clicking on "Add new user account", edit it by clicking on the "Full 
Name" link in the subscriber list and click on "Add new" link in "User IP access list 
management" table. The form allows the input of a group of consecutive IP addresses. If 
necessary, more groups can be added. The start IP address is the smallest address in the 
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group, while the number of addresses sets the size of the group. 
Screenshot: HI 

For example, if a university library had a group of IP addresses: 120.120.120.0 to 120.120.120.63 
then you would enter: 

• start IP address: 120.120.120.0 

• number of addresses: 64 

It is not necessary to add anything to the templates, or to inform the users who will be 
accessing the site through IP address authentication of the existence of this User 
Name/Password pair. 

It is also possible to search for users based their IP addresses. In the subscribers list fill in at 
least one box in the field named "IP address" from left to right. The administration screen will 
display all readers that have IP addresses matching the input. For example, if we had two 
clients, one with IP access group: 120.120.120.0:64 (start IP address 120.120.120.0, 64 
addresses), the other one with IP access group: 120.120.140.0:64 then we will have the 
following results: 

• filling in 120.120 in the IP address field will return both clients 

• filling in 120.120.120 will return only the first client: the second client's IP access group 
120.120.140 doesn't match our input 

• filling in 120.120.120.10 will return the first client 

• filling in 120.120.120.80 will return an empty list: the IP access group of the first client 
stops at 120.120.120.63 

Customizing the Subscription Form 

The subscription interface for the user is customizable. Depending on the user's status, 
several steps must be taken by a user in order to be able to read the publication. There are 
three possible scenarios: 

• The user has never subscribed. In this case, the user is served a subscription form 
(name, login, password, email etc). After the completion of this form, the user can start 
subscribing to any section 

• The user has already subscribed (i.e. is a known user to the system) but only to a few 
sections. In this case, he or she wants to add more sections to the subscriptions they 
have already made - some of which might have expired. The user should be served a 
different subscription form (reflecting his status as a known user). 

• The user is not known to the system even though his subscriptions are active (e.g. the 
subscriber hasn't logged for a long time). A login form must be supplied for such a user. 

The template designer can customize all those forms by means of Newscoop's template 
language. 
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31. 



USING PLUGINS 



Plugins enable your system administrator to add functionality to your Newscoop installation 
without having to write a large amount of code. They can also enable you to make better use 
of the content and templates already in your Newscoop publication. Currently, there are three 
plugins installed by default with Newscoop: 

• Polls: A mechanism for site visitors to vote on a question; the question can be set 
dynamically and can be multilingual 

• Interviews: Enables on-line interviews for your Newscoop publication; users have to 
refresh the page regularly to get the latest questions and answers 

• Blogs: Enables users to create and post to their own blogs, including comments 

INSTALLING NEW PLUGINS 

Once plugins are downloaded to a local hard disk, they can be uploaded to your Newscoop 
instance. Log in to your admin interface and go to Plugins -> Manage Plugins. From there you 
can select the plugin to be uploaded. Plugins must be uploaded to the Newscoop instance as a 
.tar archive. 

Selecting 'Manage Plugins' pulldown menu also provides you with a list of installed plugins; there 
is a check box to disable the plugin and a red X to delete the plugin from your system. Once a 
plugin is correctly installed, you will be able to administer it separately from the Plugins 
pulldown menu. 

Plugins require changes to your site's templates, but each plugin also includes sample 
templates to either copy and paste or to use as a guide to your own templating. 
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WHERE TO GO FOR SUPPORT 



Sourcefabric offers full commercial support for Newscoop. Additional support is provided to the 
Newscoop user and developer community. 

Forum and mailing list: You can visit the Newscoop online support forum, and sign up for the 
mailing list, at http://forum.sourcefabric.Org/index.php/f/10/ . 

This forum is mirrored by the mailing list, so posts on the forum appear on the mailing list and 
vice versa. You can therefore also post a message there by emailing: newscoop- 
support(a)lists.sourcefabric.org . 

To subscribe to forum updates via mail, please register or login to the forum by clicking the 
appropriate link. Then click the 'Subscribe' button at the top of each forum page. 

Bug reporting: Newscoop needs your input to improve. If you think you've found a bug, please 
visit http://dev.sourcefabric.org and sign in, using the same login and password that you 
registered for the Newscoop forum. Create a bug report by selecting Create Issue, then 
Newscoop, and then Bug. That way, the Newscoop team can keep track of your problem and 
notify you when it has been fixed. You can also suggest improvements and new features for 
Newscoop on that site. 

Contact: Finally, when all other avenues have been exhausted, email us directly at 
contact(a)sourcefabric.org and we'll try to help! 
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33. 



CREDITS 



Newscoop is being developed by an international community of developers and 
designers led by Sourcefabric. 

http://newscoop.sourcefabric.org 

Copyright © 2011 Sourcefabric o.p.s. 

Copyright © 1999-2010 Media Development Loan Fund. 

LICENSE 

All chapters in this manual are licensed with the GNU General Public License version 3. 

This documentation is free documentation; you can redistribute it and/or modify it under the 
terms of the GNU General Public License as published by the Free Software Foundation; either 
version 3 of the License, or (at your option) any later version. 

This documentation is distributed in the hope that it will be useful, but WITHOUT ANY 
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A 
PARTICULAR PURPOSE. See the GNU General Public License for more details. 

You should have received a copy of the GNU General Public License along with this 
documentation; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth 
Floor, Boston, MA 02110-1301, USA. 

AUTHORS 

This manual has been edited and reworked by Daniel James, based on the collaborative effort 
at FLOSS Manuals. Thanks to all contributors! 



□ 



FLOSS 

MANUALS 



Free manuals for free software 



GNU GENERAL PUBLIC LICENSE 

Version 3, 29 June 2007 

Copyright © 2007 Free Software Foundation, Inc. < http://fsf.org/ > 

Everyone is permitted to copy and distribute verbatim copies of this license document, but 
changing it is not allowed. 

Preamble 

The GNU General Public License is a free, copyleft license for software and other kinds of 
works. 

The licenses for most software and other practical works are designed to take away your 
freedom to share and change the works. By contrast, the GNU General Public License is 
intended to guarantee your freedom to share and change all versions of a program--to make 
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sure it remains free software for all its users. We, the Free Software Foundation, use the GNU 
General Public License for most of our software; it applies also to any other work released this 
way by its authors. You can apply it to your programs, too. 

When we speak of free software, we are referring to freedom, not price. Our General Public 
Licenses are designed to make sure that you have the freedom to distribute copies of free 
software (and charge for them if you wish), that you receive source code or can get it if you 
want it, that you can change the software or use pieces of it in new free programs, and that 
you know you can do these things. 

To protect your rights, we need to prevent others from denying you these rights or asking you 
to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of 
the software, or if you modify it: responsibilities to respect the freedom of others. 

For example, if you distribute copies of such a program, whether gratis or for a fee, you must 
pass on to the recipients the same freedoms that you received. You must make sure that 
they, too, receive or can get the source code. And you must show them these terms so they 
know their rights. 

Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on 
the software, and (2) offer you this License giving you legal permission to copy, distribute 
and/or modify it. 

For the developers' and authors' protection, the GPL clearly explains that there is no warranty 
for this free software. For both users' and authors' sake, the GPL requires that modified 
versions be marked as changed, so that their problems will not be attributed erroneously to 
authors of previous versions. 

Some devices are designed to deny users access to install or run modified versions of the 
software inside them, although the manufacturer can do so. This is fundamentally incompatible 
with the aim of protecting users' freedom to change the software. The systematic pattern of 
such abuse occurs in the area of products for individuals to use, which is precisely where it is 
most unacceptable. Therefore, we have designed this version of the GPL to prohibit the 
practice for those products. If such problems arise substantially in other domains, we stand 
ready to extend this provision to those domains in future versions of the GPL, as needed to 
protect the freedom of users. 

Finally, every program is threatened constantly by software patents. States should not allow 
patents to restrict development and use of software on general-purpose computers, but in 
those that do, we wish to avoid the special danger that patents applied to a free program 
could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be 
used to render the program non-free. 

The precise terms and conditions for copying, distribution and modification follow. 
TERMS AND CONDITIONS 
0. Definitions. 

"This License" refers to version 3 of the GNU General Public License. 

"Copyright" also means copyright-like laws that apply to other kinds of works, such as 
semiconductor masks. 

"The Program" refers to any copyrightable work licensed under this License. Each licensee is 
addressed as "you". "Licensees" and "recipients" may be individuals or organizations. 

To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring 
copyright permission, other than the making of an exact copy. The resulting work is called a 
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"modified version" of the earlier work or a work "based on" the earlier work. 

A "covered work" means either the unmodified Program or a work based on the Program. 

To "propagate" a work means to do anything with it that, without permission, would make you 
directly or secondarily liable for infringement under applicable copyright law, except executing 
it on a computer or modifying a private copy. Propagation includes copying, distribution (with 
or without modification), making available to the public, and in some countries other activities 
as well. 

To "convey" a work means any kind of propagation that enables other parties to make or 
receive copies. Mere interaction with a user through a computer network, with no transfer of 
a copy, is not conveying. 

An interactive user interface displays "Appropriate Legal Notices" to the extent that it 
includes a convenient and prominently visible feature that (1) displays an appropriate copyright 
notice, and (2) tells the user that there is no warranty for the work (except to the extent that 
warranties are provided), that licensees may convey the work under this License, and how to 
view a copy of this License. If the interface presents a list of user commands or options, such 
as a menu, a prominent item in the list meets this criterion. 

1. Source Code. 

The "source code" for a work means the preferred form of the work for making modifications 
to it. "Object code" means any non-source form of a work. 

A "Standard Interface" means an interface that either is an official standard defined by a 
recognized standards body, or, in the case of interfaces specified for a particular programming 
language, one that is widely used among developers working in that language. 

The "System Libraries" of an executable work include anything, other than the work as a 
whole, that (a) is included in the normal form of packaging a Major Component, but which is 
not part of that Major Component, and (b) serves only to enable use of the work with that 
Major Component, or to implement a Standard Interface for which an implementation is 
available to the public in source code form. A "Major Component", in this context, means a 
major essential component (kernel, window system, and so on) of the specific operating 
system (if any) on which the executable work runs, or a compiler used to produce the work, or 
an object code interpreter used to run it. 

The "Corresponding Source" for a work in object code form means all the source code needed 
to generate, install, and (for an executable work) run the object code and to modify the work, 
including scripts to control those activities. However, it does not include the work's System 
Libraries, or general-purpose tools or generally available free programs which are used 
unmodified in performing those activities but which are not part of the work. For example, 
Corresponding Source includes interface definition files associated with source files for the 
work, and the source code for shared libraries and dynamically linked subprograms that the 
work is specifically designed to require, such as by intimate data communication or control 
flow between those subprograms and other parts of the work. 

The Corresponding Source need not include anything that users can regenerate automatically 
from other parts of the Corresponding Source. 

The Corresponding Source for a work in source code form is that same work. 
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2. Basic Permissions. 

All rights granted under this License are granted for the term of copyright on the Program, 
and are irrevocable provided the stated conditions are met. This License explicitly affirms your 
unlimited permission to run the unmodified Program. The output from running a covered work 
is covered by this License only if the output, given its content, constitutes a covered work. 
This License acknowledges your rights of fair use or other equivalent, as provided by copyright 
law. 

You may make, run and propagate covered works that you do not convey, without conditions 
so long as your license otherwise remains in force. You may convey covered works to others 
for the sole purpose of having them make modifications exclusively for you, or provide you 
with facilities for running those works, provided that you comply with the terms of this License 
in conveying all material for which you do not control copyright. Those thus making or running 
the covered works for you must do so exclusively on your behalf, under your direction and 
control, on terms that prohibit them from making any copies of your copyrighted material 
outside their relationship with you. 

Conveying under any other circumstances is permitted solely under the conditions stated 
below. Sublicensing is not allowed; section 10 makes it unnecessary. 

3. Protecting Users' Legal Rights From Anti-Circumvention Law. 

No covered work shall be deemed part of an effective technological measure under any 
applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 
December 1996, or similar laws prohibiting or restricting circumvention of such measures. 

When you convey a covered work, you waive any legal power to forbid circumvention of 
technological measures to the extent such circumvention is effected by exercising rights under 
this License with respect to the covered work, and you disclaim any intention to limit 
operation or modification of the work as a means of enforcing, against the work's users, your 
or third parties' legal rights to forbid circumvention of technological measures. 

4. Conveying Verbatim Copies. 

You may convey verbatim copies of the Program's source code as you receive it, in any 
medium, provided that you conspicuously and appropriately publish on each copy an 
appropriate copyright notice; keep intact all notices stating that this License and any non- 
permissive terms added in accord with section 7 apply to the code; keep intact all notices of 
the absence of any warranty; and give all recipients a copy of this License along with the 
Program. 

You may charge any price or no price for each copy that you convey, and you may offer 
support or warranty protection for a fee. 

5. Conveying Modified Source Versions. 

You may convey a work based on the Program, or the modifications to produce it from the 
Program, in the form of source code under the terms of section 4, provided that you also 
meet all of these conditions: 

• a) The work must carry prominent notices stating that you modified it, and giving a 
relevant date. 

• b) The work must carry prominent notices stating that it is released under this License 
and any conditions added under section 7. This requirement modifies the requirement in 
section 4 to "keep intact all notices". 

• c) You must license the entire work, as a whole, under this License to anyone who 
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comes into possession of a copy. This License will therefore apply, along with any 
applicable section 7 additional terms, to the whole of the work, and all its parts, 
regardless of how they are packaged. This License gives no permission to license the 
work in any other way, but it does not invalidate such permission if you have separately 
received it. 

• d) If the work has interactive user interfaces, each must display Appropriate Legal 
Notices; however, if the Program has interactive interfaces that do not display 
Appropriate Legal Notices, your work need not make them do so. 

A compilation of a covered work with other separate and independent works, which are not by 
their nature extensions of the covered work, and which are not combined with it such as to 
form a larger program, in or on a volume of a storage or distribution medium, is called an 
"aggregate" if the compilation and its resulting copyright are not used to limit the access or 
legal rights of the compilation's users beyond what the individual works permit. Inclusion of a 
covered work in an aggregate does not cause this License to apply to the other parts of the 
aggregate. 

6. Conveying Non-Source Forms. 

You may convey a covered work in object code form under the terms of sections 4 and 5, 
provided that you also convey the machine-readable Corresponding Source under the terms of 
this License, in one of these ways: 

• a) Convey the object code in, or embodied in, a physical product (including a physical 
distribution medium), accompanied by the Corresponding Source fixed on a durable 
physical medium customarily used for software interchange. 

• b) Convey the object code in, or embodied in, a physical product (including a physical 
distribution medium), accompanied by a written offer, valid for at least three years and 
valid for as long as you offer spare parts or customer support for that product model, 
to give anyone who possesses the object code either (1) a copy of the Corresponding 
Source for all the software in the product that is covered by this License, on a durable 
physical medium customarily used for software interchange, for a price no more than 
your reasonable cost of physically performing this conveying of source, or (2) access to 
copy the Corresponding Source from a network server at no charge. 

• c) Convey individual copies of the object code with a copy of the written offer to provide 
the Corresponding Source. This alternative is allowed only occasionally and 
noncommercially, and only if you received the object code with such an offer, in accord 
with subsection 6b. 

• d) Convey the object code by offering access from a designated place (gratis or for a 
charge), and offer equivalent access to the Corresponding Source in the same way 
through the same place at no further charge. You need not require recipients to copy 
the Corresponding Source along with the object code. If the place to copy the object 
code is a network server, the Corresponding Source may be on a different server 
(operated by you or a third party) that supports equivalent copying facilities, provided 
you maintain clear directions next to the object code saying where to find the 
Corresponding Source. Regardless of what server hosts the Corresponding Source, you 
remain obligated to ensure that it is available for as long as needed to satisfy these 
requirements. 

• e) Convey the object code using peer-to-peer transmission, provided you inform other 
peers where the object code and Corresponding Source of the work are being offered to 
the general public at no charge under subsection 6d. 

A separable portion of the object code, whose source code is excluded from the Corresponding 
Source as a System Library, need not be included in conveying the object code work. 

A "User Product" is either (1) a "consumer product", which means any tangible personal 
property which is normally used for personal, family, or household purposes, or (2) anything 
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designed or sold for incorporation into a dwelling. In determining whether a product is a 
consumer product, doubtful cases shall be resolved in favor of coverage. For a particular 
product received by a particular user, "normally used" refers to a typical or common use of 
that class of product, regardless of the status of the particular user or of the way in which the 
particular user actually uses, or expects or is expected to use, the product. A product is a 
consumer product regardless of whether the product has substantial commercial, industrial or 
non-consumer uses, unless such uses represent the only significant mode of use of the 
product. 

"Installation Information" for a User Product means any methods, procedures, authorization 
keys, or other information required to install and execute modified versions of a covered work 
in that User Product from a modified version of its Corresponding Source. The information 
must suffice to ensure that the continued functioning of the modified object code is in no case 
prevented or interfered with solely because modification has been made. 

If you convey an object code work under this section in, or with, or specifically for use in, a 
User Product, and the conveying occurs as part of a transaction in which the right of 
possession and use of the User Product is transferred to the recipient in perpetuity or for a 
fixed term (regardless of how the transaction is characterized), the Corresponding Source 
conveyed under this section must be accompanied by the Installation Information. But this 
requirement does not apply if neither you nor any third party retains the ability to install 
modified object code on the User Product (for example, the work has been installed in ROM). 

The requirement to provide Installation Information does not include a requirement to continue 
to provide support service, warranty, or updates for a work that has been modified or 
installed by the recipient, or for the User Product in which it has been modified or installed. 
Access to a network may be denied when the modification itself materially and adversely 
affects the operation of the network or violates the rules and protocols for communication 
across the network. 

Corresponding Source conveyed, and Installation Information provided, in accord with this 
section must be in a format that is publicly documented (and with an implementation available 
to the public in source code form), and must require no special password or key for unpacking, 
reading or copying. 

7. Additional Terms. 

"Additional permissions" are terms that supplement the terms of this License by making 
exceptions from one or more of its conditions. Additional permissions that are applicable to 
the entire Program shall be treated as though they were included in this License, to the extent 
that they are valid under applicable law. If additional permissions apply only to part of the 
Program, that part may be used separately under those permissions, but the entire Program 
remains governed by this License without regard to the additional permissions. 

When you convey a copy of a covered work, you may at your option remove any additional 
permissions from that copy, or from any part of it. (Additional permissions may be written to 
require their own removal in certain cases when you modify the work.) You may place 
additional permissions on material, added by you to a covered work, for which you have or 
can give appropriate copyright permission. 

Notwithstanding any other provision of this License, for material you add to a covered work, 
you may (if authorized by the copyright holders of that material) supplement the terms of this 
License with terms: 

• a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 
16 of this License; or 

• b) Requiring preservation of specified reasonable legal notices or author attributions in 
that material or in the Appropriate Legal Notices displayed by works containing it; or 

117 



• c) Prohibiting misrepresentation of the origin of that material, or requiring that modified 
versions of such material be marked in reasonable ways as different from the original 
version; or 

• d) Limiting the use for publicity purposes of names of licensors or authors of the 
material; or 

• e) Declining to grant rights under trademark law for use of some trade names, 
trademarks, or service marks; or 

• f) Requiring indemnification of licensors and authors of that material by anyone who 
conveys the material (or modified versions of it) with contractual assumptions of liability 
to the recipient, for any liability that these contractual assumptions directly impose on 
those licensors and authors. 

All other non-permissive additional terms are considered "further restrictions" within the 
meaning of section 10. If the Program as you received it, or any part of it, contains a notice 
stating that it is governed by this License along with a term that is a further restriction, you 
may remove that term. If a license document contains a further restriction but permits 
relicensing or conveying under this License, you may add to a covered work material governed 
by the terms of that license document, provided that the further restriction does not survive 
such relicensing or conveying. 

If you add terms to a covered work in accord with this section, you must place, in the relevant 
source files, a statement of the additional terms that apply to those files, or a notice 
indicating where to find the applicable terms. 

Additional terms, permissive or non-permissive, may be stated in the form of a separately 
written license, or stated as exceptions; the above requirements apply either way. 

8. Termination. 

You may not propagate or modify a covered work except as expressly provided under this 
License. Any attempt otherwise to propagate or modify it is void, and will automatically 
terminate your rights under this License (including any patent licenses granted under the third 
paragraph of section 11). 

However, if you cease all violation of this License, then your license from a particular copyright 
holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally 
terminates your license, and (b) permanently, if the copyright holder fails to notify you of the 
violation by some reasonable means prior to 60 days after the cessation. 

Moreover, your license from a particular copyright holder is reinstated permanently if the 
copyright holder notifies you of the violation by some reasonable means, this is the first time 
you have received notice of violation of this License (for any work) from that copyright holder, 
and you cure the violation prior to 30 days after your receipt of the notice. 

Termination of your rights under this section does not terminate the licenses of parties who 
have received copies or rights from you under this License. If your rights have been 
terminated and not permanently reinstated, you do not qualify to receive new licenses for the 
same material under section 10. 

9. Acceptance Not Required for Having Copies. 

You are not required to accept this License in order to receive or run a copy of the Program. 
Ancillary propagation of a covered work occurring solely as a consequence of using peer-to- 
peer transmission to receive a copy likewise does not require acceptance. However, nothing 
other than this License grants you permission to propagate or modify any covered work. 
These actions infringe copyright if you do not accept this License. Therefore, by modifying or 
propagating a covered work, you indicate your acceptance of this License to do so. 
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10. Automatic Licensing of Downstream Recipients. 

Each time you convey a covered work, the recipient automatically receives a license from the 
original licensors, to run, modify and propagate that work, subject to this License. You are not 
responsible for enforcing compliance by third parties with this License. 

An "entity transaction" is a transaction transferring control of an organization, or substantially 
all assets of one, or subdividing an organization, or merging organizations. If propagation of a 
covered work results from an entity transaction, each party to that transaction who receives 
a copy of the work also receives whatever licenses to the work the party's predecessor in 
interest had or could give under the previous paragraph, plus a right to possession of the 
Corresponding Source of the work from the predecessor in interest, if the predecessor has it 
or can get it with reasonable efforts. 

You may not impose any further restrictions on the exercise of the rights granted or affirmed 
under this License. For example, you may not impose a license fee, royalty, or other charge 
for exercise of rights granted under this License, and you may not initiate litigation (including a 
cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, 
using, selling, offering for sale, or importing the Program or any portion of it. 

11. Patents. 

A "contributor" is a copyright holder who authorizes use under this License of the Program or 
a work on which the Program is based. The work thus licensed is called the contributor's 
"contributor version". 

A contributor's "essential patent claims" are all patent claims owned or controlled by the 
contributor, whether already acquired or hereafter acquired, that would be infringed by some 
manner, permitted by this License, of making, using, or selling its contributor version, but do 
not include claims that would be infringed only as a consequence of further modification of the 
contributor version. For purposes of this definition, "control" includes the right to grant patent 
sublicenses in a manner consistent with the requirements of this License. 

Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the 
contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise 
run, modify and propagate the contents of its contributor version. 

In the following three paragraphs, a "patent license" is any express agreement or 
commitment, however denominated, not to enforce a patent (such as an express permission 
to practice a patent or covenant not to sue for patent infringement). To "grant" such a patent 
license to a party means to make such an agreement or commitment not to enforce a patent 
against the party. 

If you convey a covered work, knowingly relying on a patent license, and the Corresponding 
Source of the work is not available for anyone to copy, free of charge and under the terms of 
this License, through a publicly available network server or other readily accessible means, 
then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to 
deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in 
a manner consistent with the requirements of this License, to extend the patent license to 
downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the 
patent license, your conveying the covered work in a country, or your recipient's use of the 
covered work in a country, would infringe one or more identifiable patents in that country that 
you have reason to believe are valid. 

If, pursuant to or in connection with a single transaction or arrangement, you convey, or 
propagate by procuring conveyance of, a covered work, and grant a patent license to some of 
the parties receiving the covered work authorizing them to use, propagate, modify or convey 
a specific copy of the covered work, then the patent license you grant is automatically 
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extended to all recipients of the covered work and works based on it. 

A patent license is "discriminatory" if it does not include within the scope of its coverage, 
prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights 
that are specifically granted under this License. You may not convey a covered work if you 
are a party to an arrangement with a third party that is in the business of distributing 
software, under which you make payment to the third party based on the extent of your 
activity of conveying the work, and under which the third party grants, to any of the parties 
who would receive the covered work from you, a discriminatory patent license (a) in 
connection with copies of the covered work conveyed by you (or copies made from those 
copies), or (b) primarily for and in connection with specific products or compilations that 
contain the covered work, unless you entered into that arrangement, or that patent license 
was granted, prior to 28 March 2007. 

Nothing in this License shall be construed as excluding or limiting any implied license or other 
defenses to infringement that may otherwise be available to you under applicable patent law. 

12. No Surrender of Others' Freedom. 

If conditions are imposed on you (whether by court order, agreement or otherwise) that 
contradict the conditions of this License, they do not excuse you from the conditions of this 
License. If you cannot convey a covered work so as to satisfy simultaneously your obligations 
under this License and any other pertinent obligations, then as a consequence you may not 
convey it at all. For example, if you agree to terms that obligate you to collect a royalty for 
further conveying from those to whom you convey the Program, the only way you could 
satisfy both those terms and this License would be to refrain entirely from conveying the 
Program. 

13. Use with the GNU Affero General Public License. 

Notwithstanding any other provision of this License, you have permission to link or combine 
any covered work with a work licensed under version 3 of the GNU Affero General Public 
License into a single combined work, and to convey the resulting work. The terms of this 
License will continue to apply to the part which is the covered work, but the special 
requirements of the GNU Affero General Public License, section 13, concerning interaction 
through a network will apply to the combination as such. 

14. Revised Versions of this License. 

The Free Software Foundation may publish revised and/or new versions of the GNU General 
Public License from time to time. Such new versions will be similar in spirit to the present 
version, but may differ in detail to address new problems or concerns. 

Each version is given a distinguishing version number. If the Program specifies that a certain 
numbered version of the GNU General Public License "or any later version" applies to it, you 
have the option of following the terms and conditions either of that numbered version or of 
any later version published by the Free Software Foundation. If the Program does not specify a 
version number of the GNU General Public License, you may choose any version ever 
published by the Free Software Foundation. 

If the Program specifies that a proxy can decide which future versions of the GNU General 
Public License can be used, that proxy's public statement of acceptance of a version 
permanently authorizes you to choose that version for the Program. 

Later license versions may give you additional or different permissions. However, no additional 
obligations are imposed on any author or copyright holder as a result of your choosing to 
follow a later version. 
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Thanks for reading! 

Visit http://flossmanuals.net to make corrections or to find more manuals. 



